Summary of Docs Team Biweekly Meeting June 21, 2022

Housekeeping

• Attendance: @ninianepress @milana_cap @atachibana @lucp @cristianozanca @femkreations @mukesh27 @rahuldsarker @anydog @estelaris @chaion07
• Where: #docs channel on 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/. Find the complete Transcript of the meeting on Slack.
• Meeting Facilitator:  @ninianepress
• Note Taker: @ninianepress
• Next Meeting Facilitator (in two weeks): @estelaris
• Next Note Taker (in two weeks): @lucp
• Next Triage Meeting Facilitator (next week): @estelaris

Open Floor

Docs Onboarding Videos

• @milana_cap published 6 onboarding sessions on wordpress.tv thanks to the TV team and @rahuldsarker.
• Two more are scheduled for June 22, 2022.
• This is a temporary location for the onboarding videos. They will be moved to the WordPress Handbook with longer descriptions.

PHPPHP PHP (recursive acronym for PHP: Hypertext Preprocessor) is a widely-used open source general-purpose scripting language that is especially suited for web development and can be embedded into HTML. https://www.php.net/manual/en/index.php Documentation Comments

@lucp and @milana_cap:

• An upwards of 60% of comments in the old PHP documentation don’t abide by WordPress coding standardsWordPress Coding Standards The Accessibility, PHP, JavaScript, CSS, HTML, etc. coding standards as published in the WordPress Coding Standards Handbook. May also refer to The collection of PHP_CodeSniffer rules (sniffs) used to format and validate PHP code developed for WordPress according to the PHP coding standards..
• @lucp posted feedback comments noting this issue.
• Most of it is around spacing and parenthesis, which will be a task for a smaller contributor dayContributor Day Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of https://make.wordpress.org/ There are many teams that people can participate in, each with a different focus. https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/.
• Escaping or internationalization is suitable for fixing now.
• @lucp will open an issue in the WordPress docs GitHub repo to track the issues that need resolving, RE: escaping and translation-fixing.
• Code reference comments (user-contributed notes) are a part of the docs team purview. Comments is the underlying code base that’s used for it.
• There’s a review process for new comments that’s completed by the DevHub team.
• User Notes (DevHub) Curators: @audrasjb, @crstauf

5.9 Issues for HelpHub

@femkreations:

• Issues with WordPress version 5.9 for the HelpHub are being worked on.
• Later, the issues will be merged into the 6.0 project.
• A lot of images don’t have ALT text and this needs to be emphasized for adding screenshots to HelpHub articles.
• @milana_cap noted that ALT text is mentioned in the docs team Handbook.
• A list will be added for this to the GitHub Issue Template for resolving on WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. contributor days.
• An extra phase in the content review process will be added to address this issue.

@milana_cap will add a link to the list on the Leading a Contribution Day Handbook page.

Props to @ninianepress for writing the notes.

#summary