HelpHub & Handbook i18n Updates

Last edition: https://make.wordpress.org/meta/2019/06/20/helphub-handbooks-localisation/

HelpHub

HelpHub is a future home for all of the WordPress user documentation currently residing in the WordPress CodexWordPress Codex Living online manual to WordPress.org https://codex.wordpress.org/. Example of a HelpHub page: https://wordpress.org/support/article/overview-of-wordpress/

Since the last update, the docs team decided to turn on the HelpHub feature on Japanese & Serbian RosettaRosetta The code name of the theme for the local WordPress sites (eg. bg.wordpress.org is a “Rosetta” site). All locale specific WordPress sites are referred to as “Rosetta sites.” The name was inspired from the ancient Rosetta Stone, which contained more or less the same text in three different languages. site first as a trial.

After the trial period, it will be activated on all Rosetta sites that have active /support section.

Currently, there is no sync mechanism between the original English content and the translation. We are also talking with Docs team about how we handle the change notification process #.

Next Steps

  • 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 will be helping with content import (ref) to prepare for the teams that want to have a copy of the original English documents.
  • LocaleLocale Locale = language version, often a combination of a language code and a region code, for instance es_MX denotes Spanish as it’s used in Mexico. A list of all locales supported by WordPress in https://make.wordpress.org/polyglots/teams/ teams: let’s start discussing how we are going to collaborate in translation & keep track of the progress.

Handbook

Handbook on Rosetta site is a section under the /team/ P2p2 "p2" is the name of the theme that blogs at make.wordpress.org use (and o2 is the accompanying plugin). When asked to post something "on the p2" by a member of the Polyglots team, that usually means you're asked to post on the team blog https://make.wordpress.org/polyglots/. (o2p2 "p2" is the name of the theme that blogs at make.wordpress.org use (and o2 is the accompanying plugin). When asked to post something "on the p2" by a member of the Polyglots team, that usually means you're asked to post on the team blog https://make.wordpress.org/polyglots/.) where you can create sets of documentation with a menu sidebarSidebar A sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme.. Example of a handbook on Rosetta site: https://ja.wordpress.org/team/handbook/

If your Rosetta site has a /team/ site already, the handbook will be automatically activated. If you need to have a /team/ site activated, post a request on this (polyglots) P2.

Information and example localized handbook can be found in the FAQ page in Polyglots Handbook.

Next Steps

  • Locale teams: decide which handbook(s) to translate and how to translate them.
  • We need to put together more information on how it works (e.g. ordering pages, creating multiple handbooks)

#announcement