First review on the new Sitemap for HelpHub

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:

1. WP Overview
   • About WordPress
   • Resources
   • FAQs
2. Technical guides
   • WordPress installation
   • WordPress multisites
   • Configuration
   • Maintenance
   • Security
   • Troubleshooting
3. Support guides
   • Get to know the dashboard
   • Publishing
   • Media
4. Customization
   • Appearance
   • Default themes
   • Classic Editor
   • BlockBlock 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.orgWordPress.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 categoryCategory 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

• Findings in the reclassification of WordPress.org documentation
• Exploration of a new classification for user documentation
• Requirements for a new design for the article pages in user documentation
• Update on the revision of documentation
• The hashtag and its future in documentation articles

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