Housekeeping
Attendance: @estelaris @ninianepress @femkreations @robinwpdeveloper @leonnugraha @colorful-tones @samanthaxmunoz @chaion07 @javiercasares
Where: #docs channel on Slack. Find the complete transcript of the meeting on Slack.
Agenda: https://make.wordpress.org/docs/2022/09/12/agenda-for-docs-team-bi-weekly-meeting-13-september-2022/
Meeting Facilitator: @estelaris
Note Taker: @ninianepress
Next Meeting Facilitator (in two weeks): @ninianepress
Next Note Taker (in two weeks): TBD
Next Triage Meeting Facilitator (next week): @milana_cap
Project Updates
WCUS Contributor Day
@femkreations shared contributor day successes at WCUS which was on September 11, 2022:
- @femkreations, @milana_cap, and @bph onboarded 10 new contributors.
- @femkreations and @bph discussed the WordPress 6.1 release as well as which tasks need to be completed.
- @femkreations completed adding the User Documentation labels to all the closed Gutenberg issues from 13.1 until 14.0.
- The walkthrough for WordPress version 6.1 was held, and will be posted on Make WordPress. It’s also available on WordPress’ YouTube channel.
WCNL Contributor Day
Yoast hosted a WCNL contributor’s day on September 14, 2022 at 10 AM – 4:30 PM UTC +2. It was available to join in-person, or online.
Open Floor
Issue When Editing Docs
@samanthaxmunoz pointed out that there’s an issue when you edit documentation pages in the back end:
- Many pages are displaying the error message: “This block contains unexpected or invalifd content.”
- The error is also displayed for pages that have recently been updated.
- If you continue seeing this issue, please open a ticket in Meta.
There was also an issue brought up by @emmaht:
- Some documentation has the block name italicized, while others don’t. (Post Author Block vs Post Author Block)
- There doesn’t appear to be an answer in the Documentation Style Guide.
Answers are awaiting upon @femkreations’s return.
Reclassification Project
@estelaris let new contributors know that part of the redesign of end-user documentation (HelpHub) is removing any articles that are for developers and/or to remove any developer jargon that is in the articles. These such articles are being reclassified into categories that make more sense and migrating others to DevHub or developer documentation.
@javiercasares spoke about successes with the Advanced Administration Handbook over WCUS Contributor’s Day online over the past weeked:
- @javiercasares opened 38 tickets, and 20 pages were formatted.
- Content is being copied in HTML from the HelpHub index, then created in markdown, and redirected to the Advanced Admin Handbook.
@javiercasares noted that the process for this is as follows:
- Create the structure. (empty files)
- Copy the original content into the new files, (using markdown) while changing the least amount as possible.
- Check all the pages for links, and old content, and try to renew it.
- Launch the new Handbook.
Noting that old pages in HelpHub will be redirected to the new ones in the Advanced Admin Handbook.