Title: HelpHub – Page 2 – Make WordPress Documentation

---

#  Category Archives: HelpHub

 [  ](https://profiles.wordpress.org/estelaris/) [Estela Rueda](https://profiles.wordpress.org/estelaris/)
10:35 am _on_ April 17, 2023      

# 󠀁[Integrating the Mobile app documentation into HelpHub](https://make.wordpress.org/docs/2023/04/17/integrating-the-mobile-app-documentation-into-helphub/)󠁿

The docs team is preparing to integrate the Mobile app end-user documentation into
HelpHub. Since it wasn’t available at the time when the new sitemap was created,
looking for a place for it is not easy.

At the moment, the Mobile App is split into 6 categories, mostly written in the 
FAQ format.

 * Getting started
 * Troubleshooting Login/signup issues
 * Domains
 * Images, video and audioMy sites
 * My account
 * My sites
 * Posts and pages

### Next steps

Docs team has opened a[ project in GitHub](https://github.com/orgs/WordPress/projects/89)
to begin content review.

What needs to be reviewed:

 * All links – broken, outdated and find replacements
 * Content – still relevant, has anything changed in the last version?
 * Images – need new screenshots?
 * Features – are there new features that are not documented yet?
 * New issues – are we missing documentation for any other issue?

### Classification

The team is also reviewing the classification to find a better pattern for users.
Since the articles are written in an FAQ form, perhaps some articles can be rewritten
in the new template as “feature description + how it works.”

### Help wanted

Anyone wanting to help with content review, reach out to [@estelaris](https://profiles.wordpress.org/estelaris/)
in the [#docs](http://wordpress.slack.com/messages/docs/) SlackSlack Slack is a 
Collaborative Group Chat Platform [https://slack.com/](https://slack.com/). The 
WordPress community has its own Slack Channel at [https://make.wordpress.org/chat/](https://make.wordpress.org/chat/)
channel.

[[+make.wordpress.org/marketing/
[](https://make.wordpress.org/themes/)[](https://make.wordpress.org/themes/)[](https
://make.wordpress.org/support/)+make.wordpress.org/support/

[[+make.wordpress.org/mobile/
[](https://make.wordpress.org/themes/)[](https://make.wordpress.org/themes/)[](https
://make.wordpress.org/training/)+make.wordpress.org/training/

 * [Login to Reply](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fdocs%2F2023%2F04%2F17%2Fintegrating-the-mobile-app-documentation-into-helphub%2F%23respond&locale=en_US)

 [  ](https://profiles.wordpress.org/estelaris/) [Estela Rueda](https://profiles.wordpress.org/estelaris/)
2:11 pm _on_ April 10, 2023     
Tags: [docs ( 159 )](https://make.wordpress.org/docs/tag/docs/)

# 󠀁[Introducing the Advanced Administration handbook](https://make.wordpress.org/docs/2023/04/10/introducing-the-advanced-administration-handbook/)󠁿

During the recategorization of the documentation, the team removed several articles
that were developer-focused or included a lot of developer-jargon. All these articles
are now part of the [Advanced Administration Handbook](https://developer.wordpress.org/advanced-administration/)
and will be removed from [/documentation/devhub/](https://wordpress.org/documentation/category/devhub/).

The redirects have been applied as indicated in [issue #59](https://github.com/WordPress/wporg-documentation-2022/issues/59).
Some articles have been merged to provide better explanations. Although, the maintenance
is still ongoing, most of the articles have been updated.

Please report any issues to the [documentation GitHub issue tracker](https://github.com/WordPress/Documentation-Issue-Tracker).

Props to [@ryelle](https://profiles.wordpress.org/ryelle/) and [@javiercasares](https://profiles.wordpress.org/javiercasares/)
for working on this issue.

[#docs](https://make.wordpress.org/docs/tag/docs/)

 * [Login to Reply](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fdocs%2F2023%2F04%2F10%2Fintroducing-the-advanced-administration-handbook%2F%23respond&locale=en_US)

 [  ](https://profiles.wordpress.org/femkreations/) [Femy Praseeth](https://profiles.wordpress.org/femkreations/)
10:12 pm _on_ March 15, 2023     
Tags: 6.2, [docs ( 159 )](https://make.wordpress.org/docs/tag/docs/),
[helphub ( 44 )](https://make.wordpress.org/docs/tag/helphub/)   

# 󠀁[Call for volunteers to help with 6.2 end user documentation](https://make.wordpress.org/docs/2023/03/15/call-for-volunteers-to-help-with-6-2-end-user-documentation/)󠁿

The Docs team needs your help to update and revise the End User Documentation (HelpHub)
for the upcoming WordPress 6.2 release, expected on March 28, 2023.

You can find a list of all the tasks in the [6.2 project board](https://github.com/orgs/WordPress/projects/67/views/2)
in the Documentation’s repo on GitHubGitHub GitHub 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 by the repository owner. [https://github.com/](https://github.com/).

The tasks have been sorted into [medium priority tasks](https://github.com/orgs/WordPress/projects/67/views/10)
and [high priority tasks](https://github.com/orgs/WordPress/projects/67/views/11).
The team plans to complete the [high priority tasks](https://github.com/orgs/WordPress/projects/67/views/11)
by the 6.2 scheduled release date.

## How you can help

If you are new to the Docs team, you can select from the list of [good first issues](https://github.com/orgs/WordPress/projects/67/views/12).

If you are new to contributing to WordPress, you can review this [onboarding post](https://make.wordpress.org/docs/2022/06/13/live-onboarding-sessions-for-the-documentation-team/)
with training videos and links to help you get started.

Based on what you are interested in, review the [medium priority tasks](https://github.com/orgs/WordPress/projects/67/views/10),
[high priority tasks](https://github.com/orgs/WordPress/projects/67/views/11) or
[good first issues](https://github.com/orgs/WordPress/projects/67/views/12).

Mention in a comment on the GitHub issue you would like to work on and someone on
the Docs team will assign it to you.

Once a task is assigned to you, the following two videos show how to help with updating
the existing articles in End User Documentation (HelpHub).

Video onboarding to End User documentation

Video showing how to help with updating the existing articles on GitHub

If you have questions or need help, ask in the [docs channel](https://wordpress.slack.com/archives/C02RP4WU5)
on the Make WordPress SlackSlack Slack is a Collaborative Group Chat Platform [https://slack.com/](https://slack.com/).
The WordPress community has its own Slack Channel at [https://make.wordpress.org/chat/](https://make.wordpress.org/chat/)
or directly in the GitHub issue itself. If your meetupMeetup All local/regional 
gatherings that are officially a part of the WordPress world but are not WordCamps
are organized through [https://www.meetup.com/](https://www.meetup.com/). A meetup
is typically a chance for local WordPress users to get together and share new ideas
and seek help from one another. Searching for ‘WordPress’ on meetup.com will help
you find options in your area. or firm can give a 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. of time to help, do include the
Release co-leads for 6.2 documentation in your message: (Slack IDs) [@bph](https://profiles.wordpress.org/bph/),
[@zzap](https://profiles.wordpress.org/zzap/), [@Femy](https://profiles.wordpress.org/femy/),
and [@abhanonstopnewsuk](https://profiles.wordpress.org/abhanonstopnewsuk/).

## Resources

If you need a test site with WordPress 6.2 pre-installed, you can [use this app provided by InstaWP](https://app.instawp.io/launch?t=betarc&d=v1)
to spin up a new temporary website set. It is preloaded with Theme Test data and
other pre-configuration, ready to go. This new site will be available to use for
four hours. After that, if you need another test site to contribute to docs, you
can visit the link again and create a new temporary site.

_Props to [@bph](https://profiles.wordpress.org/bph/) [@webcommsat](https://profiles.wordpress.org/webcommsat/)
[@milana\_cap](https://profiles.wordpress.org/milana_cap/) for collaborating and
reviewing this article._

[#6-2](https://make.wordpress.org/docs/tag/6-2/), [#docs](https://make.wordpress.org/docs/tag/docs/),
[#helphub](https://make.wordpress.org/docs/tag/helphub/)

 * [Login to Reply](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fdocs%2F2023%2F03%2F15%2Fcall-for-volunteers-to-help-with-6-2-end-user-documentation%2F%23respond&locale=en_US)

 [  ](https://profiles.wordpress.org/estelaris/) [Estela Rueda](https://profiles.wordpress.org/estelaris/)
5:58 pm _on_ February 7, 2023     
Tags: [helphub ( 44 )](https://make.wordpress.org/docs/tag/helphub/)

# 󠀁[Future plans for HelpHub](https://make.wordpress.org/docs/2023/02/07/future-plans-for-helphub/)󠁿

At the end of January, the docs and metaMeta Meta is a term that refers to the inside
workings of a group. For us, this is the team that works on internal WordPress sites
like WordCamp Central and Make WordPress. teams launched the new site for documentation,
internally known as HelpHub. The team’s work is not done as we are still updating
old articles and continue writing new ones. The goal is to release new feature articles
as close to the latest WordPress version release as possible.

## Still missing and tracking

 1. Update legacy colors[ #26](https://github.com/WordPress/wporg-documentation-2022/issues/26)
 2. The change log is still a work in progress[ #6](https://github.com/WordPress/wporg-documentation-2022/issues/6)
 3. Finish the documentation inventory [https://github.com/orgs/WordPress/projects/23](https://github.com/orgs/WordPress/projects/23)
 4. Review the [handbook pages for HH](https://make.wordpress.org/docs/handbook/helphub/)
    and update all
 5. Review and close [HH meta tickets](https://meta.trac.wordpress.org/query?status=!closed&component=HelpHub)
 6. Review and close tickets on[ HH developing repository](https://github.com/WordPress/HelpHub/issues)

## Next steps

Promote the work, tell the world! Announce it everywhere. It has been 8 years since
the [HelpHub project kicked-off](https://make.wordpress.org/support/2015/01/kicking-off-helphub/).
Most of the initial members are not around as contributors any longer.

The documentation team will continue working in bringing the updated documentation
and promote collaboration with other teams, like:

 1. Discuss with polyglots teamPolyglots Team Polyglots Team is a group of multilingual
    translators who work on translating plugins, themes, documentation, and front-facing
    marketing copy. [https://make.wordpress.org/polyglots/teams/](https://make.wordpress.org/polyglots/teams/)
    how can we help in implementing the new site map and reorganizing articles that
    are already translated. This effort will be different with each local team as it
    will depend on the local teams processes and availability.
 2. Update content with polyglots – can we create GH issue track per rosetta site? 
    What would be the best process for each locale.
 3. Introducing the new documentation and developer sites in WordCamps, during Contributor
    DayContributor Day Contributor Days are standalone days, frequently held before
    or after WordCamps but they can also happen at any time. They are events where 
    people get together to work on various areas of [https://make.wordpress.org/](https://make.wordpress.org/)
    There are many teams that people can participate in, each with a different focus.
    [https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/](https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/)
    so we can encourage other teams to implement the changes in their own languages.
 4. Work with the training team to create a crosslink Resources 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. where we can 
    link Learn videos/courses/tutorials and vice versa.

_Props to _[@milana_cap](https://profiles.wordpress.org/milana_cap/) _for reviewing
the content of this article._

[#helphub](https://make.wordpress.org/docs/tag/helphub/)

 * [Login to Reply](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fdocs%2F2023%2F02%2F07%2Ffuture-plans-for-helphub%2F%23respond&locale=en_US)

 [  ](https://profiles.wordpress.org/estelaris/) [Estela Rueda](https://profiles.wordpress.org/estelaris/)
11:46 am _on_ January 24, 2023      

# 󠀁[New look, new site, new HelpHub](https://make.wordpress.org/docs/2023/01/24/new-look-new-site-new-helphub/)󠁿

The docs team have been working hard on creating the [end-user documentation](https://wordpress.org/documentation/)
or HelpHub. It took a [very long time](https://make.wordpress.org/support/2015/01/kicking-off-helphub/),
8 years to be exact since the project kicked-off, and we reached the goal. Follow
the journey from these posts [Kicking off HelpHub](https://make.wordpress.org/support/2015/01/kicking-off-helphub/)
and [New design for HelpHub in WordPress.org.](https://make.wordpress.org/docs/2022/10/19/new-design-for-helphub-in-wordpress-org/)

## Introduction to the new Documentation site

The look changed to be in harmony with the rest of the 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/](https://wordpress.org/)
template. The new features were created with the goal to facilitate search for end-
users. Some of these features are:

 * a simplified sitemap divided into 4 categories and each categoryCategory The '
   category' taxonomy lets you group posts / content together that share a common
   bond. Categories are pre-defined and broad ranging. has several subcategories,
 * better definition between end-user and developers documentation, meaning that
   several articles will be moved into developers.wordpress.org in the next few 
   weeks,
 * change to the menu item to documentation instead of support,
 * a new menu, breadcrumbs and other features

## The four categories

The goal of the end-user documentation is to provide information to non-developers
or new users so they try resolving their issue by themselves instead of going directly
to the Forums.

To improve search, the team worked on reclassifying the articles into 4 main categories:

 * **WordPress overview**, where users can find general information about WordPress,
   versions, FAQs and resources.
 * **Technical guides** to help with installation, maintenance, and security.
 * **Support guides** to get familiar with the software and its features.
 * **Customization** where users can find instructions on how to use the 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
   and default themes.

[⌊Image showing the documentation landing page with its four categories and subcategories.⌉⌊
Image showing the documentation landing page with its four categories and subcategories
.⌉[

## End-user and developers documentation

When moving the articles from the Codex, there was a separation between developer-
focused and end-user-focused documentation. Yet, developer articles were still available
within in end-user documentation.

To help make the distinction better, all developer jargon has been removed from 
end-user documentation and moved to [developer.wordpress.org](http://developer.wordpress.org).

## Documentation instead of support

The menu item was support, the docs team has been looking into changing the menu
item into documentation. Documentation is better description than support.

[[

## Features

### Breadcrumbs and a submenu

Users can use the breadcrumbs to return to a specific page, category or subcategory
without navigating all the way to the landing page.

[[

A new submenu was added for fastest linking to [developers documentation](https://developer.wordpress.org/),
the [forums](https://wordpress.org/support/forums/) and the docs team make blog.

[[

### Sticky table of content for articles

The new TOC in the articles is a sticky item with one link to take the user back
to the top.

Video showing how the sticky TOC works within an article.

Props to [@milana_cap](https://profiles.wordpress.org/milana_cap/), [@kenshino](https://profiles.wordpress.org/kenshino/),
and [@atachibana](https://profiles.wordpress.org/atachibana/) for their direction
on this project.

Props to [@javiarce](https://profiles.wordpress.org/javiarce/), [@joen](https://profiles.wordpress.org/joen/)
and [@beafialho](https://profiles.wordpress.org/beafialho/) for their design guidance,
help and commitment on the last stage.

Props to [@ryelle](https://profiles.wordpress.org/ryelle/) for her amazing coding
work.

 * [Login to Reply](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fdocs%2F2023%2F01%2F24%2Fnew-look-new-site-new-helphub%2F%23respond&locale=en_US)

 [  ](https://profiles.wordpress.org/estelaris/) [Estela Rueda](https://profiles.wordpress.org/estelaris/)
2:20 pm _on_ January 23, 2023     
Tags: [docs ( 159 )](https://make.wordpress.org/docs/tag/docs/)

# 󠀁[Support, forums, training or documentation](https://make.wordpress.org/docs/2023/01/23/support-forums-training-or-documentation/)󠁿

There are several ways to find information regarding the features or issues in WordPress
and each one of them has a function and a time. This is a short explanation of what
each means, the difference and when to use them.

## What is what?

A good way to differentiate them is to define them and to provide use cases for 
each. None is better or worst than the other neither is any more or less important.
It all depends on when they are used.

 * **Support **is 1:1, requires interaction and it is used for more urgent issues,
   whether is a chatbot or person and is immediate.
 * **Forums** are intended for broader help or best advice on specific topics. Most
   of the time is asynchronous but is monitored by a team or person, paid or volunteer.
   Most importantly, forums are community driven.
 * **Documentation** are basically instructions on how to do things. There is no
   interaction of any kind for questions. Literally, “what you read is what you 
   get.”
 * **Training** creates lessons on topics. These can be on video or written form.
   Can be individual or part of a series. And training can be immediate or in the
   user’s own time.

## Some use cases

Users require information for different reasons and search for it in different ways.

For instance, hosting companies use **support**, either by chat or call, to resolve
a user’s issue. Whether is urgent or not, it usually is something that the user 
cannot solve by themselves or it has an immediate need for solution.

The **forums** are topical and in threads. They are very useful for discussions 
and to provide guidance over an issue or topic. Forums are monitored and conversation
are mostly asynchronous. Some of the uses could be a school discussion group, product
sales, best practices, product help, product how-to’s, etc.

When a user wants to learn fairly quick how to do something, following the steps
in a **documentation** article is the best way. There are no interactions and the
user reads it in their own time.

In opposition to wanting to deeply learn about a subject, then the user would search
for a **training** lesson or course.

## What can a user find in 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/](https://wordpress.org/)󠁿

WordPress.org does not provide support. There is no team that will reply to questions
1:1 at any time. Instead there are the Forums that are monitored by contributors,
volunteer and paid, that reply to questions posted.

There is documentation for end-users and developers and there are training lessons
offered in Learn.

> It is a strong recommendation by the documentation team to stop using the word
> support and instead refer to each instance with their respective name.
> _Props_ to @milana_cap and @atachibana for the review of this article.

[#docs](https://make.wordpress.org/docs/tag/docs/)

 * [Login to Reply](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fdocs%2F2023%2F01%2F23%2Fsupport-forums-training-or-documentation%2F%23respond&locale=en_US)

 [  ](https://profiles.wordpress.org/estelaris/) [Estela Rueda](https://profiles.wordpress.org/estelaris/)
4:16 pm _on_ January 16, 2023     
Tags: [helphub ( 44 )](https://make.wordpress.org/docs/tag/helphub/)

# 󠀁[Development and design work continues on Helphub](https://make.wordpress.org/docs/2023/01/16/developing-and-design-work-continues-on-helphub/)󠁿

Docs team, please refrain from updating/uploading articles on Helphub still. Work
will continue until Friday 20 January.

I will update the team if we need more time.

For questions, pingPing The act of sending a very small amount of data to an end
point. Ping is used in computer science to illicit a response from a target server
to test it’s connection. Ping is also a term used by Slack users to @ someone or
send them a direct message (DM). Users might say something along the lines of “Ping
me when the meeting starts.” [@estelaris](https://profiles.wordpress.org/estelaris/)
on docs SlackSlack Slack is a Collaborative Group Chat Platform [https://slack.com/](https://slack.com/).
The WordPress community has its own Slack Channel at [https://make.wordpress.org/chat/](https://make.wordpress.org/chat/)
channel.

[#helphub](https://make.wordpress.org/docs/tag/helphub/)

 * [Login to Reply](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fdocs%2F2023%2F01%2F16%2Fdeveloping-and-design-work-continues-on-helphub%2F%23respond&locale=en_US)

 [  ](https://profiles.wordpress.org/estelaris/) [Estela Rueda](https://profiles.wordpress.org/estelaris/)
6:42 pm _on_ January 7, 2023     
Tags: [docs ( 159 )](https://make.wordpress.org/docs/tag/docs/)

# 󠀁[There is work in progress in HelpHub (Documentation)](https://make.wordpress.org/docs/2023/01/07/there-is-work-in-progress-in-helphub-documentation/)󠁿

This post is to ask everyone who has access to HelpHub, to please refrain from adding,
editing or publishing old or new articles as of the writing of this post.

MetaMeta Meta is a term that refers to the inside workings of a group. For us, this
is the team that works on internal WordPress sites like WordCamp Central and Make
WordPress. team is working on the replacement of the /support/ site for a /documentation/
site and whatever is not there as of today, will be lost.

Please hold off any updates until after 17 January 2023. If you have any questions,
reach out to [@estelaris](https://profiles.wordpress.org/estelaris/) on [#docs](https://make.wordpress.org/docs/tag/docs/)
SlackSlack Slack is a Collaborative Group Chat Platform [https://slack.com/](https://slack.com/).
The WordPress community has its own Slack Channel at [https://make.wordpress.org/chat/](https://make.wordpress.org/chat/)
or leave a comment below.

 * [Login to Reply](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fdocs%2F2023%2F01%2F07%2Fthere-is-work-in-progress-in-helphub-documentation%2F%23respond&locale=en_US)

 [  ](https://profiles.wordpress.org/estelaris/) [Estela Rueda](https://profiles.wordpress.org/estelaris/)
9:18 pm _on_ November 14, 2022     
Tags: [agenda ( 175 )](https://make.wordpress.org/docs/tag/agenda/),
[meetings ( 169 )](https://make.wordpress.org/docs/tag/meetings/)   

The next meeting is scheduled with the following details:

When: [**Tuesday, 15 November, 2022, 04:00 PM GMT+**1](https://www.timeanddate.com/worldclock/fixedtime.html?msg=Docs+bi-weekly+meeting&iso=20221115T14&p1=1440&ah=1)

Where: [#docs](https://wordpress.slack.com/messages/docs/) channel on [Slack](http://www.slack.com/)

Agenda:

 1. Attendance
 2. Note-taker & Facilitator selection for Next Meeting
 3. Projects checks
 4. Alterations on HelpHub design pages to sync with new WP.org template
 5.  * Changelog is a collapsible item
     * Changelog and Feedback form switched placement
     * Adding descriptions to categories & subcategories on landing page, will affect
       mobile length
     * Adding description to articles in categoryCategory The 'category' taxonomy lets
       you group posts / content together that share a common bond. Categories are 
       pre-defined and broad ranging. page (no description on subcategory) – will affect
       mobile length
     * Article content switch sides, long content to the left and article TOC to the
       right
     * Figma [i1 vs i4](https://www.figma.com/file/iM8I9yAYbwjbc9q9b2WWui/Documentation---HelpHub-%2F-WordPress.org?node-id=1235%3A2987&t=S5lECgeW7HH4Fexq-1)
 6. [First iteration for DevHub](https://www.figma.com/file/2WxlJFzMJvqPfZL1EkAOVp/Developer-Pages?node-id=1%3A2196&t=S5lECgeW7HH4Fexq-1)
    new design
 7.  * Content review (landing page: what goes, what stays?)
     * Improvements only to articles not inside handbooks
     * Design in general
 8. Open floor

If there’s anything you’d like to discuss on the open floor, please leave the comment
below.

[#agenda](https://make.wordpress.org/docs/tag/agenda/), [#meetings](https://make.wordpress.org/docs/tag/meetings/)

 * [Login to Reply](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fdocs%2F2022%2F11%2F14%2F13791%2F%23respond&locale=en_US)

 [  ](https://profiles.wordpress.org/estelaris/) [Estela Rueda](https://profiles.wordpress.org/estelaris/)
9:01 pm _on_ October 19, 2022     
Tags: [docs ( 159 )](https://make.wordpress.org/docs/tag/docs/),
[helphub ( 44 )](https://make.wordpress.org/docs/tag/helphub/)   

# 󠀁[New design for HelpHub in WordPress.org](https://make.wordpress.org/docs/2022/10/19/new-design-for-helphub-in-wordpress-org/)󠁿

The end-user documentation or [HelpHub](https://wordpress.org/support/) will go 
through a transformation, both in the design and the site map. 

The refinements in the template will improve the user experience while searching
for information. These improvements include one landing page for end-user and developers
documentation that will be called Documentation. This is the entry port to both 
HelpHub and [DevHub](https://developer.wordpress.org/). Although this article focuses
on HelpHub, there will be changes for DevHub in the future.

[⌊Showing the look of the new end-user documentation landing page showing the 4 
categories and subcategories under each in two columns. There are links to developers
documentation and the forums at the bottom of the page.⌉⌊Showing the look of the
new end-user documentation landing page showing the 4 categories and subcategories
under each in two columns. There are links to developers documentation and the forums
at the bottom of the page.⌉[

## Better search

The new [site map](https://docs.google.com/spreadsheets/d/11RxfocYIC8NjdS5em0yTk4eGGwZPhZbnR7E-CzUGT84/edit?usp=sharing)
includes 4 main categories and subcategories under each. This will improve search
and allow new articles to be added into the existing categories without creating
a ‘miscellaneous’ categoryCategory The 'category' taxonomy lets you group posts /
content together that share a common bond. Categories are pre-defined and broad 
ranging..

[⌊New site map showing categories and subcategories⌉⌊New site map showing categories
and subcategories⌉[

## New features

Documentation will have a new headerHeader The header of your site is typically 
the first thing people will experience. The masthead or header art located across
the top of your page is part of the look and feel of your website. It can influence
a visitor’s opinion about your content and you/ your organization’s brand. It may
also look different on different screen sizes.. The team is dropping the word ‘Support’
and replacing it with ‘Documentation’. This area of the website will contain reference
information rather than be a place where users interact with the Support team as
described in the [Renaming WordPress.org Support to Documentation](https://make.wordpress.org/meta/2022/10/11/renaming-wordpress-org-support-to-documentation/).

[⌊The new header for end-user documentation replaces the word Support for Documentation⌉⌊
The new header for end-user documentation replaces the word Support for Documentation⌉[

A changelog was added to keep historic information on each article. The user will
have a better idea of how recent the information is.

[⌊Example of changelog⌉⌊Example of changelog⌉[

Other features that will help searching are the breadcrumbs, a new documentation
submenu to the categories, a more prominent table of content and, a highlighted 
link to Support Forums.

[⌊Example showing placement for breadcrumbs table of contents and documentation 
search box, including the Support Forums block. ⌉⌊Example showing placement for 
breadcrumbs table of contents and documentation search box, including the Support
Forums block. ⌉[

Another new feature was the retirement of the hash character at the end of the headlines
as they were an accessibilityAccessibility Accessibility (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) issue and caused visual noise. The hash has been replaced by a link
icon.

[⌊Appearance phases for the headlines⌉⌊Appearance phases for the headlines⌉[

## Documentation on mobile

The mobile version offers faster access to the specific topic in the article by 
using accordions to navigate long articles on mobile. The breadcrumbs, search and
table of contents will remain at the top of the article.

[⌊Example of a documentation article on mobile.⌉⌊Example of a documentation article
on mobile.⌉[

## The design

The design follows the style set by the News redesign. It is cleaner, jazzier and
the new template opens the canvas to improve readability. Using also the same typography
connects this design to the redesign of WordPress.

The color palette is simple and muted so as to not interfere with the multiple videos
and screenshots used within the articles.

The work started at [WCEU 2019 Contributors Day](https://europe.wordcamp.org/2019/)
in Berlin. The following articles describe the work previously done.

 * [Findings in the reclassification of WordPress.org documentation](https://make.wordpress.org/docs/2020/02/21/findings-in-the-reclassification-of-wordpress-org-documentation/)
 * [Exploration of a new classification for end-user documentation](https://make.wordpress.org/docs/2020/06/22/exploration-of-a-new-classification-for-user-documentation/)
 * [Requirements for a new design for the article pages in end-user documentation](https://make.wordpress.org/docs/2021/02/01/requirements-for-a-new-design-for-the-article-pages-in-user-documentation/)
 * [Update on the revision of documentation](https://make.wordpress.org/docs/2021/04/05/update-on-the-revision-of-documentation/)
 * [The hashtag and its future in documentation articles](https://make.wordpress.org/docs/2022/02/20/the-hashtag-and-its-future-in-documentation-articles/)
 * [First review on the new site map for HelpHub](https://make.wordpress.org/docs/2022/03/07/first-review-on-the-new-sitemap-for-helphub-or-documentation/)
 * [Reclassification of end-user documentation](https://make.wordpress.org/docs/2022/10/05/reclassification-of-end-user-documentation/)

Props to [@milana_cap](https://profiles.wordpress.org/milana_cap/), [@kenshino](https://profiles.wordpress.org/kenshino/),
and [@atachibana](https://profiles.wordpress.org/atachibana/) for their direction
on this project.

Props to [@tobiasfeistmantl](https://profiles.wordpress.org/tobiasfeistmantl/), 
[@fmellitzer](https://profiles.wordpress.org/fmellitzer/), [@davidvie](https://profiles.wordpress.org/davidvie/),
[@majaloncar](https://profiles.wordpress.org/majaloncar/), [@pendraq](https://profiles.wordpress.org/pendraq/),
[@igorel](https://profiles.wordpress.org/igorel/), [@nobnob](https://profiles.wordpress.org/nobnob/),
[@marcio-zebedeu](https://profiles.wordpress.org/marcio-zebedeu/), [@chaion07](https://profiles.wordpress.org/chaion07/),
[@netpassprodsr](https://profiles.wordpress.org/netpassprodsr/), [@bph](https://profiles.wordpress.org/bph/),
[@timohaver](https://profiles.wordpress.org/timohaver/), [@dmivelli](https://profiles.wordpress.org/dmivelli/),
who contributed to the reclassification project.

Props to [@melchoyce](https://profiles.wordpress.org/melchoyce/), [@karmatosed](https://profiles.wordpress.org/karmatosed/),
and [@beafialho](https://profiles.wordpress.org/beafialho/) for their design guidance.

Props to [@webcommsat](https://profiles.wordpress.org/webcommsat/) and [@marybaum](https://profiles.wordpress.org/marybaum/)
for reviewing and editing help of this article.

[#docs](https://make.wordpress.org/docs/tag/docs/), [#helphub](https://make.wordpress.org/docs/tag/helphub/)

 * [Login to Reply](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fdocs%2F2022%2F10%2F19%2Fnew-design-for-helphub-in-wordpress-org%2F%23respond&locale=en_US)

# Post navigation

[← Older posts](https://make.wordpress.org/docs/category/helphub/page/3/?output_format=md)

[Newer posts →](https://make.wordpress.org/docs/category/helphub/?output_format=md)