Welcome to the official home of the WordPress Documentation Team.
This team is responsible for coordinating all documentation initiatives around WordPress, including the handbooks and other general wordsmithing across the WordPress project.
Want to get involved?
Start here to find out more about what we do and how to contribute:
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/
Weekly meetings
Join our discussions of documentation issues here on the blog and on Slack.
In general, hyphenate compound adjectives ending with -based such as ARM-based, application-based, and HTMLHTMLHTML is an acronym for Hyper Text Markup Language. It is a markup language that is used in the development of web pages and websites.-based.
Use an en dash if based follows a term with two or more words.
Don’t use to refer to a position in the UI. In general, avoid using directional language in instructions to locate UI elements or other content. Directional language proves to be difficult for accessibility or for localization. People with cognitive impairments, as well as people using assistive technologies such as screen-reading software and might have difficulty interpreting directional language. If a particular UI element or other content is difficult to convey, include a screenshot or illustration.
Tip:Recommended: WordPress 5.8 BetaBetaA pre-release of software that is given out to a large group of users to trial under real conditions. Beta versions have gone through alpha testing in-house and are generally fairly close in look, feel and function to the final product; however, design changes often occur as part of the process. 4
Tip:Recommended: WordPress has released a betaBetaA pre-release of software that is given out to a large group of users to trial under real conditions. Beta versions have gone through alpha testing in-house and are generally fairly close in look, feel and function to the final product; however, design changes often occur as part of the process. version of 5.8.
Use between when referring to two or more distinct things.
Example
Tip:Recommended: These are the main differences between WordPress.comWordPress.comAn online implementation of WordPress code that lets you immediately access a new WordPress environment to publish your content. WordPress.com is a private company owned by Automattic that hosts the largest multisite in the world. This is arguably the best place to start blogging if you have never touched WordPress before. https://wordpress.com/ and WordPress.
Don’t interchange between with among. Use among when referring to two or more things that aren’t distinct.
In general, don’t hyphenate words beginning with bi- such as bimodal, biweekly, and bidirectional, unless bi- is followed by a proper noun or it is absolutely necessary to avoid confusion.
In general, emphasize on the task to be accomplished, rather than how the user should interact with the UI element. Refer to a box by its label instead of field. If you have to use a descriptor, use the complete term such as list box or checkbox.
Not Buddypress, Buddy press, Buddy Press, or buddypress.
Exception: It is OK to use buddypress in lowercase in developer documentation such as commands, or BuddyPress URLs. For example, codex.buddypress.org/.
In general, emphasize on the task to be accomplished, rather than how the user should interact with the UI element. Refer to a button by its label. If you have to use a descriptor, use button.
