HelpHub Localisation Plan Meeting

Tuesday, 26th March 2019, at 2PM UTC

Documentation, polyglots and community teams are joining forces in an effort to make localisation come through for HelpHub. The same system could possibly be used for localising Make / Community handbooks.

Detailed explanation can be found here: HelpHub Localisation Plan.

The first meeting will be conducted via Zoom (downloading app is mandatory but registering to the website is not needed). Link for the meeting will be shared afterwards.

Meeting is will happen on

Tuesday, March 26, 2019, 14:00 UTC

Everyone interested are welcome to participate.

Agenda for Docs Team Meeting 18 March 2019

Our next Documentation Team meeting is scheduled on

Monday, March 18, 2019, 15:00 UTC

in the #docs channel on Slack

Current Projects Updates:

  1. Content Migration from Codex to HelpHub & DevHub – @atachibana
  2. HelpHub development – @milana_cap
  3. Inline Docs – @drewapicture and @atimmer
  4. Gutenberg Handbook – @dryanpress @chrisvanpatten and @nosolosw

    Now we have “Block Editor” icon on the DevHub main page: https://developer.wordpress.org/
    But, the plan of moving contents is not clear from previous discussion. Can anyone explain it in the meeting or on #docs?

Open Floor

Feel free to comment if you have items to add to the agenda.

Summary for HelpHub meeting 11 March 2019

Attendance

@milana_cap @atachibana @daveryan @iviolini @kartikshukla @jessecowens @softservenet @dinamiko @nullbyte @kafleg @kenshino @audrasjb attended

Development (Phase 1.5)

GitHub -> Trac: @milana_cap is collating issues that need moving towards Trac. We’re making sure that issues related to the portions of HelpHub that are committed to WordPress.org are tracked on Meta.Trac as patches would have to be provided there.

We also now have a proper slack channel #meta-helphub to discuss HelpHub development.

A regular bug scrub (perhaps once per month) will likely be planned and @milana_cap & @clorith will work out an appropriate time.

The GitHub repository will still be used for Phase 2 (working out code pieces that are not yet committed to WordPress.org) and the staging environment wp-helphub.com will accommodate all code staging work. The repository has also been transferred to the WordPress Team – with the original team keeping autonomy on the repository.

Content (Phase 1.5)

We’re still working on migrating all WordPress version articles from Codex to HelpHub. So far about 90% of the articles have been migrated (props to @atachibana @kartikshukla @jarretc @subrataemfluence and @audrasjb)

The core team has already been using HelpHub to publish release notes since WordPress 5.0

Progress is being tracked via this Google Sheet – while migration is mostly done, @atachibana and team are working on the review and publishing process.

Block Editor Docs

@milana_cap, @clorith and a great team of volunteers helped copy over the block editor docs contributed from the peeps at Automattic (WordPress.com).

Existing docs that refer to classic editor will be cloned and new block editor docs will be created and prefixed with -block-editor

  • https://wordpress.org/support/article/pages-add-new-screen/ will refer to the old way of adding new pages
  • https://wordpress.org/support/article/pages-add-new-screen-block-editor will refer to the post WordPress 5.0 way of adding new pages

The old docs will be kept and the new docs will be linked straight from HelpHub’s homepage.

@daveryan will be working alongside @atachibana to determine if there are any more key block editor (Gutenberg) docs to be written. (Basically we should be providing enough information to help people get to learn the block editor)

The new block editor user docs are available here – https://wordpress.org/support/category/block-editor/

Design

@iviolini is taking some time to get familiar with the needs of HelpHub. The WordPress versions require a proper archive page and that will likely be one of the first tasks to be worked on.

Localisation Plan

We’re still working out the technical aspects of the plan. But as it seems, the Community Team requires very similar work done to their Community Handbooks.

So we’re looking at a combined tech approach across Docs, Meta, Polyglots and Community Teams. (We have some peeps from Multilingual Press who are going to chime in too)

@milana_cap is trying to convene a Zoom call to get all related parties together and an appropriate time is being decided on this Doodle. Do fill it in if you’re interested – particularly if you are able to provide technical expertise and time to work our the issues.

You can read what went on in the meeting via Slack logs.


X-post: Strengths and Challenges: Organization

X-comment from +make.wordpress.org/updates: Comment on Strengths and Challenges: Organization

Agenda for HelpHub meeting 11 March 2019

Hello all,

Next HelpHub meeting will happen on

Monday, March 11, 2019, 15:00 UTC
  1. Attendance
  2. Phase 1.5 Check-in
  3. Detailed content discussions
    • Content Migration Check-in (@atachibana)
    • Gutenberg Docs (@daveryan)
  4. HelpHub localisation
  5. Setup regular development bug scrub
  6. AOB

Helpful Links

  • HelpHub Staging – https://wp-helphub.com/
  • GitHub repo – https://github.com/kenshino/helphub
  • State of HelpHub (read for Phase 2) – https://make.wordpress.org/docs/2018/02/26/state-of-helphub-february-2018/
  • Last HelpHub meeting minutes – https://make.wordpress.org/docs/2019/02/26/summary-for-helphub-team-meeting-25-february-2019/

X-post: HelpHub Localisation Plan

X-post from +make.wordpress.org/polyglots: HelpHub Localisation Plan

X-post: 5.0 Release Retrospective Kickoff

X-comment from +make.wordpress.org/updates: Comment on 5.0 Release Retrospective Kickoff

Summary for HelpHub Team Meeting 25 February 2019

Attendees: @atachibana @softservenet @felipeelia @kartiks16

Phase 1.5 Check-in

Status: https://docs.google.com/spreadsheets/d/1PeHj7pSFLcdMbIC41JJdzEkl12TJT3mwWyzQv2mi01U/edit#gid=554277336
Phase 1.5 Contents were migrated 37/53 (70%).
Version Texts were migrated 48/349 (38%).

If anyone has interests in these activities, please read this document or contact @atachibana https://make.wordpress.org/docs/handbook/helphub/migrating-articles/

Gutenberg User Docs

In previous meeting, we decided to re-use Gutenberg Help contents of WordPress.com. I listed up current HelpHub contents that should be modified to adapt them.
https://docs.google.com/spreadsheets/d/1PeHj7pSFLcdMbIC41JJdzEkl12TJT3mwWyzQv2mi01U/edit#gid=2125284625
Also, we should prepare special pages such as accessibility or troubleshooting.

HelpHub localization

@kenshino posted localiation plan of HelpHub at Polyglots
https://make.wordpress.org/polyglots/2019/02/25/helphub-localisation-plan
Any comments and questions are welcome.

Agenda for HelpHub meeting 25 February 2019

Hello all,

Next HelpHub meeting will happen on

Monday, February 25, 2019, 15:00 UTC
  1. Attendance
  2. Phase 1.5 Check-in
  3. Detailed content discussions
    • Content Migration Check-in
    • Gutenberg User Docs contribution from WordPress.com
  4. HelpHub localisation
    • Draft here – https://docs.google.com/document/d/1d5a64LN564zB-HrxvRr9u1zKepD5yaVYb-cL02r5euQ/edit?ts=5c47e862
  5. AOB

Helpful Links

  • HelpHub Staging – https://wp-helphub.com/
  • GitHub repo – https://github.com/kenshino/helphub
  • State of HelpHub (read for Phase 2) – https://make.wordpress.org/docs/2018/02/26/state-of-helphub-february-2018/
  • Last HelpHub meeting minutes – https://make.wordpress.org/docs/2019/01/28/summary-for-docs-team-meeting-28-january-2019/

Summary for Docs Team Meeting 18 February 2019

Attendees: @atachibana @milana_cap @subrataemfluence @joyously @Pixelateddwarf

Codex Deprecation (Content Migration

@atachibana

  • On going: Status is here: https://docs.google.com/spreadsheets/d/1PeHj7pSFLcdMbIC41JJdzEkl12TJT3mwWyzQv2mi01U/edit#gid=554277336
  • @subrataemfluence migrated & set transfer tab of 23 Version Pages.

DevHub

No update.

HelpHub Development

@milana_cap

  • HelpHub repository was moved under the WordPress org
    https://github.com/WordPress/HelpHub
  • #meta-helphub, the dedicated channel for HelpHub development was created
  • @jrf fixed Travis Settings error

Inline Docs

No updates.

Gutenberg Handbook

@atachibana will prepare the plan of Gutenberg user docs.

Open Floor

@joyously asked about internationalization of PHP update page
https://wordpress.org/support/update-php/
@dd32 explained it at #polyglots to translators:
It can be translated at
https://translate.wordpress.org/projects/meta/forums/fr/default?filters%5Bterm%5D=update-php
and it will be
https://fr.wordpress.org/support/update-php/
in case of French. Other languages are the same.

@subrataemfluence mentioned about the lacking of complete examples about Gutenberg development. After this meeting, @mkaz posted
“We are working on improving navigation in the handbook, but there is a tutorial section which has a few complete examples
https://wordpress.org/gutenberg/handbook/designers-developers/developers/tutorials/”