The WordPress Documentation Style Guide is one of Google Season of Docs' projects for 2020.
- Technical writer: Atharva Dhekne (@tacitonic)
- Mentors: Felipe Elia (@felipeelia) and Milana Cap (@zzap)
Quick links:
- WordPress Documentation Style Guide
- Google Season of Docs original project proposal for tacitonic (Atharva Dhekne) – Google Developers
- WordPress Documentation Style Guide – Google Season of Docs 2020 Project Report
| Status | Description |
|---|---|
| 🔄 | In progress |
| ✔️ | Completed |
| ❌ | Discarded |
| Needs changes |
| Component | Status |
|---|---|
| WordPress style guide | ✔️ |
| Style guide highlights | ✔️ |
| Other resources | ✔️ |
| Changelog | ✔️ |
| Component | Status |
|---|---|
| Accessibility | ✔️ |
| Document structure | ✔️ |
| Changes to the guide (New component) | ✔️ |
| Encoding | ✔️ |
| External sources | ✔️ |
| Facts | ✔️ |
| Fonts | ✔️ (Moved to Formatting) |
| Global audience | ✔️ |
| Inclusivity | ✔️ |
| Legality, licensing, trademarks | ✔️ (Moved to Formatting) |
| Multi-platform accessibility | ✔️ |
| Non-ambiguous, no excessive claims | ✔️ |
| Page layout | ✔️ |
| Political correctness | ✔️ |
| Protocols | ✔️ |
| Security | ✔️ |
| Sentence structure | ✔️ |
| Succinct writing | ✔️ |
| Tone and style | ✔️ |
| Unbiased | ✔️ |
| Component | Status |
|---|---|
| Abbreviations and acronyms | ✔️ |
| Affirmation and negation | ❌ |
| Articles | ✔️ |
| Capitalization | ✔️ |
| Clause | ✔️ |
| Contractions (New component) | ✔️ |
| Direct/indirect speech | ✔️ |
| Genders | ✔️ (Moved to Pronouns) |
| Glossary | (Moved to Word Usage Dictionary) |
| Grammatical person | ✔️ |
| Nouns | ✔️ |
| Plurals (New component) | ✔️ |
| Possessives (New component) | ✔️ |
| Prefixes and suffixes | ✔️ |
| Prepositions | ✔️ |
| Pronouns | ✔️ |
| Referencing | ✔️ (Moved to Formatting) |
| Slang and jargon | ✔️ (Moved to Word Choice) |
| Spellings | ✔️ (Moved to Word Choice) |
| Technical terms | ✔️ (Moved to Word Choice) |
| Tense | ✔️ |
| Verbs | ✔️ |
| Voice | ✔️ |
| Word choice (New component) | ✔️ |
| Component | Status |
|---|---|
| Apostrophes | ✔️ |
| Colons | ✔️ |
| Commas | ✔️ |
| Dashes (split from Hyphens) | ✔️ |
| Ellipses | ✔️ |
| Exclamation points | ✔️ |
| Hyphens | ✔️ |
| Parentheses | ✔️ |
| Periods | ✔️ |
| Question marks | ✔️ |
| Quotation marks (split from Apostrophes) | ✔️ |
| Semicolons (split from Colons) | ✔️ |
| Slashes | ✔️ |
| Component | Status |
|---|---|
| Abstracts, introduction, prefaces | ❌ |
| Brand names, product names | ✔️ |
| Captions | ✔️ (Moved to Media) |
| Code snippets, code blocks | ✔️ (Moved to Code) |
| Currencies | ✔️ (Moved to Numbers) |
| Date and time, time zones, places | ✔️ |
| Examples and scenarios (New component) | ✔️ |
| Filenames | ✔️ |
| Footnotes | ✔️ |
| Headings and titles | ✔️ |
| Highlighting (Bold, italics, underline, strikethrough, quotation) | ✔️ (Moved to Text formatting) |
| Indentation | ❌ |
| Index | ❌ |
| Key terms (New component) | ✔️ |
| Links and URLs | ✔️ (Moved to Linking) |
| Lists, bullet points, numbering | ✔️ |
| Media (Images, videos) and illustrations | ✔️ |
| Notices (Notes, warnings, tips) | ✔️ |
| Numbers | ✔️ |
| Obsolete content (New component) | ✔️ |
| Phone numbers | ✔️ |
| Polyglots, translation, language scripts | ✔️ |
| Referencing | ✔️ (Moved to Linking) |
| Spacing | ✔️ (Moved to Text formatting) |
| Tables | ✔️ |
| Text formatting | ✔️ |
| Trademarks, copyrights, patents, citations | ✔️ |
| Tutorials and procedures | ✔️ |
| Typography and fonts | ✔️ (Moved to Text formatting) |
| UI elements | ✔️ (Moved to User interface) |
| Units of measurement | ✔️ |
| Words as words (New component) | ✔️ |
| Component | Status |
|---|---|
| Cross-references | ✔️ |
| External links | ✔️ |
| Heading links | ✔️ |
| Image links | ✔️ |
| Link text | ✔️ |
| Component | Status |
|---|---|
| Activities | ✔️ |
| Buttons | ✔️ |
| Code snippets, code blocks | ✔️ |
| Command line interface | ✔️ |
| Dialogs | ✔️ |
| Menus and dropdowns | ✔️ |
| Pop-ups and alerts | ✔️ |
| Tabs | ✔️ |
| Terminology | ✔️ |
| UI elements | ✔️ |
| Windows | ✔️ |
| Component | Status |
|---|---|
| Code in text (New component) | ✔️ |
| Code examples | ✔️ |
| Coding standards (New component) | ✔️ |
| Command-line syntax | ✔️ |
| CSS | ✔️ (Moved to Coding standards) |
| HTML | ✔️ (Moved to Coding standards) |
| JS | ✔️ (Moved to Coding standards) |
| Markdown | ✔️ (Moved to Coding standards) |
| MySQL | ❌ |
| PHP | ✔️ (Moved to Coding standards) |
| Placeholder formatting (New component) | ✔️ |
| Syntax | ✔️ |
| Terminology | ✔️ |
| UI elements | ✔️ |
| XML | ❌ |
| Component | Status |
|---|---|
| Numbers | ✔️ |
| Symbols | ✔️ |
| A | ✔️ |
| B | ✔️ |
| C | ✔️ |
| D | ✔️ |
| E | ✔️ |
| F | ✔️ |
| G | ✔️ |
| H | ✔️ |
| I | ✔️ |
| J | ✔️ |
| K | ✔️ |
| L | ✔️ |
| M | ✔️ |
| N | ✔️ |
| O | ✔️ |
| P | ✔️ |
| Q | ✔️ |
| R | ✔️ |
| S | ✔️ |
| T | ✔️ |
| U | ✔️ |
| V | ✔️ |
| W | ✔️ |
| X | ✔️ |
| Y | ✔️ |
| Z | ✔️ |
| Component | Status |
|---|---|
| Media > Videos | |
| API reference documentation |