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.
Note:Highlight: End all independent sentences with a period, and insert one space after the period.
End all independent sentences with a period, and insert one space after the period. If the sentence or phrase ends with punctuation other than a period, such as a question mark or exclamation point, don’t use a period.
Ending a URL or file path immediately with a period may confuse readers and even alter the URL.
If the period isn’t part of the URL, you can differentiate it by highlighting it different than normal text. In most browsers, a link is highlighted blue by default, which helps to differentiate it from the period. When you put a period after a URL, don’t leave any space between the last character of the URL and the period.
To indicate that the period ending a sentence is not a part of the URL, you can rewrite the sentence so that the URL isn’t at the end. Another alternative is to exclude the period by putting the URL on a separate line other than the text.
Examples
Warning:Not recommended: For more information on accessibility, refer https://wordpress.org/about/accessibility/.
Warning:Not recommended: For more information on accessibility, refer https://wordpress.org/about/accessibility/ .
Tip:Recommended: For more information on accessibilityAccessibilityAccessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility), refer:
If the last part of a sentence ends within parentheses, insert the period after the closing parenthesis. If a complete, independent sentence is enclosed within parentheses, include the period inside the parentheses.
Examples
Tip:Recommended: You can categorize your post with multiple tags (the default tag is uncategorized).
Tip:Recommended: Making changes to the code while running the server could cause errors in your databases. (Specifically, it can cause corrupted tables or duplicate values.)
If a sentence or phrase ends with content inside quotation marks, place the period inside the quotation marks, even if it doesn’t belong in the quoted content. If the sentence or phrase inside the quotation marks ends with punctuation other than a period, such as a question mark or exclamation point, don’t use a period.
Examples
Tip:Recommended: The developer said, “This APIAPIAn API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways. is the newest version.”
Tip:Recommended: Regarding regular updates, the user asked, “When can we expect a version update?”
Use periods at the end of shortened words. Don’t use periods with acronyms and initialisms. Similarly, don’t use periods with commons words that are abbreviations such as app or demo.
