Following up on the post Explorations of a new classification for user documentation, we suggested to create 4 pillars (categories) and subcategories. My suggestion is to keep the subcategories to the minimum and add as many articles as needed, this will allow the system to grow as needed.
The 4 pillars in HelpHub
The 4 suggested pillars with their own subcategories are:
- WP Overview
- About WordPress
- Resources
- FAQs
- Technical guides
- WordPress installation
- WordPress multisites
- Configuration
- Maintenance
- Security
- Troubleshooting
- Support guides
- Get to know the dashboard
- Publishing
- Media
- Customization
- Appearance
- Default themes
- Classic Editor
- Block Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. Editor
- Common Blocks
- Formatting
- Layout elements
- Theme Blocks
- Widgets
- Embeds
What has been done
During Google Season of Docs 2020, there was a project to reclassify all the articles, change article titles to follow the new style guide being written at the time and review the content (including links, outdated content, etc).
These are some of title changes given and the team will discuss the next steps to either change the affected URLs or not, but that is for another post.
Due to the rotation of contributors and the team focusing on other issues, the revision of content is still ongoing. If you would like to help out, join a meeting or reach out to @femkreations on WordPress.org The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https://wordpress.org/, @Femy on Slack and she will guide you.
The new titles and the reclassification has been done. We will continue to include articles that are still to be written, as well as any new article.
The first draft
This is a first draft of the Sitemap and we need your help to make sure articles are in the correct category The 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging. or if there is anything else we need to add. You can leave your comments on this post or in the Draft of the Sitemap linked above.
What is up for review
- Category names
- Subcategory names
- Articles classified in the correct category/subcategory
What is not for review
- The four pillars (the title yes, but we won’t be adding anymore pillars)
- Order of articles under categories nor order of subcategories (we will review them at a later time)
- New name titles for articles (these were given during GSoD and have been already reviewed and accepted/rejected by the #docs team)
Other articles written as part of the redesign of HelpHub
If you would like to contribute or have any questions, reach out to @estelaris on Slack or leave a comment.
Props to @milana_cap for peer review.
#helphub