Summary of Docs Team Meeting March 8, 2022

Housekeeping

• Attendance: @estelaris @femkreations @milana_cap @atachibana @tlc1206 @themiked @juanmaguitar @kafleg
• Where: #docs channel on Slack. Find the complete Transcript of the meeting on Slack.
• Meeting Facilitator:  @tlc1206
• Note Taker: @milana_cap
• Agenda: https://make.wordpress.org/docs/2022/03/08/agenda-for-docs-team-bi-weekly-meeting-8-march-2022/
• Next Meeting Facilitator (in two weeks): @tlc1206

Project updates

Docs issue tracker

Updates for issues repo in last 7 days: https://make.wordpress.org/updates/2022/03/07/documentation-team-update-march-7-2022/

WordPress 6.0 release

Docs focus team for WordPress 6.0 release had a first meeting yesterday. If anyone likes to join, help with writing parts of docs, just watch the process, get involved in whatever form, you can do so by stating your interest in #docs slackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. channel or pinging @milana_cap (zzap in slack).

Everyone is welcome to join #6-0-release-leads; you might not be able to post but you’ll see the process and what’s happening.

End user 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 docs

• catching up with 5.9 – Updating these pages is still priority as we are not up to date with WordPress 5.9. If you’d like to help out, take a look at this project: https://github.com/WordPress/Documentation-Issue-Tracker/projects/3
• categoryCategory The 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging. added to pages inventory – @femkreations created the long list of articles related to blocks and @estelaris added a new column to the project to add the category, that way contributors will know where to add any new articles on that list https://github.com/orgs/WordPress/projects/23
• missing articles for 5.9 – @femkreations created about 56 new trackers for the missing pages for the Blocks in the end user docs and added them to the “Block Editor End User Docs Update to 5.9” project

General end user docs

• new sitemap – @estelaris wrote First review on the new Sitemap for HelpHub and needs feedback on it.
• replacing hashtag – @estelaris opened ticket with #meta for evaluating 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) issues and design for removing the hashtag https://meta.trac.wordpress.org/ticket/6171

Developer docs

• technical parts removed from HelpHub – @femkreations created a GH Projects that has the inventory of the technical parts that are removed from the end user docs https://github.com/orgs/WordPress/projects/26/views/1. It’s a work in progress. If you’d like to help, 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.” @femkreations (Femy in slack).

Needs feedback

• First review on the new Sitemap for HelpHub – one of discussion questions – should FAQ articles live separately in FAQ category or be in their respective sections
• Change article titles part 1 – it was recommended from Marketing team (@jonoaldersonwp) to change URLs as well and use 301 redirects – we have to ask in 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. for options to do this.
• URLs for new HelpHub articles – we don’t have anything about this in Style Guide and @femkreations needs directions for those missing articles in 5.9. Proposed solution is to follow consistency where possible (e.g. adding -block for block articles and embed- for embed blocks) and leave other slugs to be created naturally from the title.

#summary