Summary for Docs Team meeting 27 May 2019

Attendance: @kenshino, @atachibana, @aurooba, @welcher, @ibdz, and @otto42

Content Migration from Codex to HelpHub & DevHub

@aurooba lead Contributor day contributions to the Docs in Calgary and completed Version Notes Redirection. Thank you @aurooba, @trailerthree, @djmayes19, @carlsonwebtech, and @kmhazari.

Version 3.7.28, Version 3.7.22 were set In Process by someone, @atachibana will handle them. Once that’s done, any clicks into Codex’s version notes will go straight to HelpHub now.

Next Focus: Redirecting remaining Phase 1 Content and the rest of the Codex

@aurooba volunteered to tackle the remaining Phase 1 redirection but noticed some weren’t redirected because of certain issues/errors. Example: Editing wp-config.php says No permissions to edit this site. It seems permissions were locked on this Codex page, possibly because some docs were getting defaced regularly.

@aurooba will be making a list of URLs that need to be unblocked for @otto42 to fix.

Currently 11 Phase 1 docs are left to redirect, the goal is to get them all redirected this week. @aurooba is aiming to complete them all this week.

Once that’s complete, we can move our focus to redirecting DevHub next week onwards. c.c. @jonoalderson @joostdevalk

HelpHub development

Skipped HelpHub Development because @milana_cap was not around. But we’re still in a chronic situation of needing developers.

Inline Docs

Skipping Inline Docs as @drewapicture and @atimmer are not present today.

Gutenberg Handbook

@nosolosw, @mkaz, @chrisvanpatten weren’t present so @kenshino gave a quick summary of what he knew:

We’ve successfully released https://developer.wordpress.org/block-editor/. All the early issues have been ironed out thanks to @nosolosw @mkaz @chrisvanpatten @coffee2code

There is some work being done to improve the side bar navigation currently. @welcher opened a ticket about the Handbook Sidebar: https://meta.trac.wordpress.org/ticket/4476. @ibdz will review the sidebar related issues and discuss it in the next meeting.

“More info” section on Code Reference pages

Reference: https://make.wordpress.org/docs/2019/05/13/the-best-way-to-use-the-more-info-section/

@kenshino: I’d like to keep that issue open longer to get more feedback! Please comment your thoughts there!

Centralised API handbook

Reference: https://meta.trac.wordpress.org/ticket/4376

@kenshino mentioned the ticket has a good outline in place for next steps, and the technical implementation is just setting up a new handbook custom post type.

@kenshino will ask Meta team this week on how we can push this forward.

Who’s in the Docs Team

We want to make sure that everyone that has Docs Team designation has a specific role to play – be it a project lead or a regular contributor

  • Docs Team Lead
  • HelpHub Development Lead
  • Content Lead
  • User Notes Curator?
  • Theme Handbook Lead?
  • Plugin Handbook Lead?
  • And more?

Please make suggestions and comments about these roles in the comments below.

People will be assigned these roles in the next Docs Team meeting

You can read a transcript of this meeting at: https://wordpress.slack.com/archives/C02RP4WU5/p1558969441038300