Summary of Docs Team Meeting March 8, 2022


Project updates

Docs issue tracker

Updates for issues repo in last 7 days:

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 The WordPress community has its own Slack Channel at 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

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). ( issues and design for removing the hashtag

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 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 1it 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.