Documentation Issue Tracker on GitHub: Submit any Documentation Team-related issues on GitHubGitHubGitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/
Join our discussions of documentation issues here on the blog and on Slack.
If you’re creating and naming new files where other files have a different naming convention, see if the other files and folders can be renamed with the aforementioned guidelines. If you cannot change existing filenames, it is acceptable to use underscores or other naming conventions that are in use, to remain consistent with the existing style.
For example, if the directory already has files named as theme_1.php, theme_2.php, and theme_3.php, it’s acceptable to name the new file as theme_4.php instead of theme-4.php.
Not recommended:newcache.php, newCache.php, new-caché.php
Not recommended:wpsettings1.php, wpSettings1.php, WPSettings1.php, wp-settings1.php, wpsettings-1.php
It’s acceptable to have some inconsistency in file and folder names if it can’t be avoided otherwise. There might be predefined design and style guidelines or undocumented guidelines that are already in use. Sometimes, file naming can also be automated by the product. In those cases, it’s okay to make exceptions for those files.