Summary of Docs Team Biweekly Meeting July 19th, 2022


Project Checks

  • @milana_cap re-wrote the homepage and requests feedback in the ticket
  • @milana_cap started working on team roles page.
  • Updated Team page with open positions (see rep positions below).
  • Completed and reviewed 5.9 Block Editor Doc Project tasks:
  • HelpHub design and reclassification project updates from @estelaris:
    • Waiting on a site map review for some articles to move to DevHub.
    • Update two items on the design: change dev docs link for a dev 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. similar to the support block and change items in the menu.
    • Update the images on the post.
    • Plan to release the post with the new design on Thursday, July 21.

DevHub Handbook: Advanced Administration

A 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. TracTrac Trac is the place where contributors create issues for bugs or feature requests much like GitHub. ticket is now open for new handbook. Currently, there are developer and end-user docs, but many unsorted docs fall under an “advanced administration” term. Most of the content will be pulled from:

  • HelpHub – Pages that are too technical for end-user docs (see “Technical guides” column in HelpHub sitemap spreadsheet).
  • Codex – Pages that have not been migrated to DevHub/HelpHub because they did not fit into either.

Approving User-Contributed Notes

@lucp linked to a Slack conversation on pending comments on DevHub, some of them dating back for a year. There is ongoing discussion about how to best handle this and a Meta ticket that proposes emailing users when a comment is approved/deleted.

Rep Positions

There are three open rep positions. Those interested should contact @milana_cap.

  • Block Editor Developer Handbook
  • More Info Curator (Code reference)
  • Upcoming Advanced Administration Handbook

See onboarding video for more information. Also, see the complete list of roles.

Open Floor

@colorful-tones started a draft on patterns for the theme developer handbook.

@bph noted that comments on the upcoming developer blog editorial process close on July 20.

#meetings, #summary