Summary for Docs team on December 07, 2020


Attendance

@chaion07, @bph, @paaljoachim, @atachibana, @mkaz, @tacitonic, @estelaris, @tjnowell, @fahimmurshed, @kenshino, @joyously,

Thanks to @chaion07 for facilitating the meeting.

Housekeeping

Project updates

  • @atachibana reported that the contents team continued migrating and re-routing Codex to Code Reference, and in this week we processed: Hooks: 224 of 355 (63.1 % from 56.1% the last week) by @stevenlinx and @Mathew McCabe
  • External Linking Policy – there was a lack of input from the team on the post but we have a deadline so for the first review of Plugin Developer Handbook we have two reviewers (even though we are aiming for 3) – @themiked and myself. I’ve already done the one for “undoubtedly allowed” links. @themiked please do yours this week if you can so that we can start applying results and keep the deadline by the end of this year.
  • GSoD Documentation Style Guide – I’m working on manifest.json file which is needed for parsing GitHub markdown files to our very new Style Guide Handbook. Once I finish it, I’ll ping some good people from meta to run it for the first time. Really looking forward to seeing this one.
  • We are asking all #docs team members to read the above post about External Linking Policy. We need your decisions and votes. As it is now, this will be a “two persons” decision.

:bee: -docs update
We have still three orphan pages on our to-do-list for 5.6

New meeting time and holiday break announcement

The team chose to change the weekly meeting time to 14:00 UTC and this is the last meeting of the year 2020. We will reconvene again on 11 January 2021 at 14:00 UTC.

Monthly Coffee Break December 2020

After some discussion, we decided to skip the coffee break this month as it is too tight between the holidays and the State of the Word.

Google Season of Docs

Style Guide by @tacitonic

  • @milana_cap started with the manifest file for the Style Guide.
  • I’m currently writing the Formatting section.

Classification project by @dmivelli

  • I’ve reviewed the New Classification Recs tab on our worksheet.
  • I created new columns with subcategory suggestions for WP overview and Technical docs.
  • I’m still working on the Technical docs column.
  • I’ll continue this week and check in on progress by next weekend.
  • Link to the spreadsheet. We ask that peeps do not change anything, but feel free to add comments.
  • Also, the final reports by mentors and technical writer were submitted to Google last week.

There was a discussion as to what language (American English) is the basis of the style guide and there will be a focus on internationalizing the language. Also, the discussion area in GH is open, feel free to leave your comments there.

Discussion: Clarification about the use of GPL by WordPress plugins and themes

There was a discussion previous to the meeting on Slack. The conclusion is to point docs to the license page. @themiked clarified that the license question asked a few weeks back was mashed out and the license page for the plugin handbook was updated to include a link to the general WP license page and suggested the same approach is taken for the theme handbook.

#meeting-notes