Summary for Docs team on December 07, 2020


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

Thanks to @chaion07 for facilitating the meeting.


Project updates

  • @atachibana reported that the contents team continued migrating and re-routing Codex to Code Reference, and in this week we processed: HooksHooks In WordPress theme and development, hooks are functions that can be applied to an action or a Filter in WordPress. Actions are functions performed when a certain event occurs in WordPress. Filters allow you to modify certain functions. Arguments used to hook both filters and actions look the same.: 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 PluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the Plugin Directory or can be cost-based plugin from a third-party 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.jsonJSON JSON, or JavaScript Object Notation, is a minimal, readable format for structuring data. It is used primarily to transmit data between a server and web application, as an alternative to XML. file which is needed for parsing GitHubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. markdown files to our very new Style Guide Handbook. Once I finish it, I’ll 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.” some good people from 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. 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

  • Updates: Image 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. page
  • new page: Image Editing features
  • Updates to Latest Posts
  • New contributor @incapit works on their first page.
  • Another new contributor will be on-boarded this week.
  • Experienced contributors are progressing in their work. @newyorkerlaura@cguntur @bizanimesh@collinsmbaka @geheren

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 WordState of the Word This is the annual report given by Matt Mullenweg, founder of WordPress at WordCamp US. It looks at what we’ve done, what we’re doing, and the future of WordPress.

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 GPLGPL GPL is an acronym for GNU Public License. It is the standard license WordPress uses for Open Source licensing The GPL is a ‘copyleft’ license This means that derivative work can only be distributed under the same license terms. This is in distinction to permissive free software licenses, of which the BSD license and the MIT License are widely used examples. 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.