Summary for Docs Team Meeting: 18 May 2020


@makewebbetter @atachibana @mkaz @marcio-zebedeu @annezazu @milana_cap @chaion07 @bph @ibdz @collinsmbaka @nobnob @estelaris @crstauf @timohaver @immeet94  @sasiddiqui @themiked @kenshino @miss_jwo @milana_cap @shajiaabidi @shubhampalriwala @prubhtej @cbringmann @tacitonic @leslie @kartiks16 @jackF @pratikchauhan @mukesh27


You can find the Agenda here.

Notetaker: @collinsmbaka

Notes Reviewed by: @makewebbetter and @chaion07

Facilitator: @estelaris

Facilitator for Next Meeting: @chaion07

Follow the meeting on the Slack channel for Docs

Project Updates

@atachibana reported that the re-routing of the Codex page to Code Reference functions, 949 out of 1064 (which is roughly 88.8%) have been completed. He thanked @collinsmbaka and @stevenlinx for their contributions.

@bph is collaborating with @cguntur and @tacitonic to onboard new contributors and testing instructions.

Season of Docs Update

@estelaris shared the link to Technical writer guide | Season of Docs and urged anyone interested in participating in GSoD to fill out.

@cbringmann emphasized that they had a fair amount of interest from technical writers. They also added questions as comments to the technical writer post and are requesting a response from the docs team to complete their proposal.

Other questions from technical writers [ @shubhampalriwala, @prubhtej, @tacitonic ] present during the meeting which were diligently answered by @cbringmann.

@kenshino suggested that a mid-step should be done internally. He had raised a few projects for people who didn’t have time to write, but the registered mentors could be reshuffled to choose the right project for them

@kenshino suggested that we should create a post to work this out.

@estelaris shared the link to Season of Docs Project List Idea – Make WordPress Documentation for anybody with questions on Season of Docs to read.

External links discussion and distributions

@estelaris emphasized that we need to decide whether we allow or not, external linking in WordPress documentation. She provided External Linking in Docs Policy – Make WordPress Documentation for everyone to go through.

@kenshino read through them and emphasized his general thoughts are, I quote ”in line with our general ethos of the WP project, I’d like to see us being more permissive than restrictive’’ he then suggested a few principles to guide this process as 

  • Our focus should still be on enhancing the official docs / making it complete. So it would make sense for us to encourage people to substantiate our docs with their content first.
  • If somehow that is not possible or if the external content is useful but not suitable as official information, it’s fine to add external links.
  • It should be easy for good resources to be listed: We can have trusted sources by default – I’m happy for us to just build that list as we go along.
  • It should be easy for bad resources to be removed – even if you were once trusted.
  • Curation is essential – but it does not have to be a day job.

@estelaris emphasized that we need a workflow to avoid curation becoming a day job. @kenshino replied that he hasn’t gotten that far, but agrees that we do need some sort of workflow. @milana_cap once again volunteered to work on it.

Tasks for WCEU online contributors’ day

@milana_cap emphasized that she’d like to use this post for all the WCEU contributors’ day info. And she received some information from @mkaz for Good First Issue Gutenberg

@milana_cap also urged those who plan to attend 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 There are many teams that people can participate in, each with a different focus. or have a question or idea should comment on that post.

@ester had provided a link for clarification of timezone of the event referring to the question of @mkaz and @milana_cap.

@milana_cap requested the Official reps of Docs Team to make lists of specific tasks and send, so she can add them to the post.

@milana_cap also provided examples of actionable tasks below,

  • Actionable task: Review these function reference pages: link, link, link, link.. and make sure escaping and internationalization are correct and in place.

@milana_cap also reminds us that anyone who wants to attend WCEU needs to register. @estelaris replied with the registration link 

@estelaris added that they will open new tickets for contributor day, but you need to be registered for the 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. too.

Please feel free to suggest any changes to the meeting notes by mentioning in comments !