Summary for Docs Team Meeting 28 October 2019

This meeting had an agenda to cover all the main topics:

Attendance

@felipeelia, @atachibana, @milana_cap, @tomf, @kenshino, @bph, @felipeloureirosantos

Topics

Updates

@leogermani updates:

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. migrations are stalled for the last two weeks

I’ve been working in the localization content for the common APIs handbook. Hopefully this week I’ll manage to have something to show

Docs handbook review: This page https://make.wordpress.org/docs/handbook/helphub/migrating-articles/ have 2 sections talking about migrating the Versions pages. Apparently this taks is completed already and could be removed

@atachibana updates:

Content: 256 of 1068 (23.9%) pages were redirected. Last week was 241 of 1068 (22.6%).

https://docs.google.com/spreadsheets/d/15hpEbbnuWJZ0DJafyCeG3CFRMtSxX1gY-RObrrjzzdw/edit#gid=1576070270

During these works, I was suggested by johnbillion to report all inline documentation fix under the one ticket: https://core.trac.wordpress.org/ticket/48303

I modified Docs Team Handbook to relect this change: https://make.wordpress.org/docs/handbook/code-reference/inline-documentation/

@estelaris updates:

The team at 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://2017.us.wordcamp.org/contributor-day/ https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/. WC Valencia came up with good ideas, but after reviewing their individual input and adding the comments left on the P2P2 P2 or O2 is the term people use to refer to the Make WordPress blog. It can be found at https://make.wordpress.org/. I posted 2 weeks ago, we came up with what it looks like the final version

Handbook

As discussed during our last meeting, our focus on this meeting was the Docs Team Handbook.

According to @milana_cap, our Handbook has been forgotten for a long time until recently when we started updating and reorganising it, each team member is responsible for a part on the Handbook, and may review and update all guidelines around it. It’s only natural that those people update the same parts of Handbook because they know the best how to contribute to that project and who to talk to.

@milana_cap also pointed out that we are also missing the 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. editor documentation guidelines, and that we are missing someone who’s going to “own” it.

Then @felipeelia asks about the “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 WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party Handbook Rep: Open” from the projects list.

@milana_cap remembers that plugin handbook is actually shared between plugin review team and docs, and that main ownership is by plugin team.

@Kenshino proposes about clarifies if the Plugin Team is updating the pages based on the latest changes to WordPress, and propose about contacting @ipstenu.

@milana_cap highlights that the main goal of the handbooks is that people that want to add something in notes or want to contribute, they should be able to go to our handbook, find info on how to start, which document to go to, which TrelloTrello Project management system using the concepts of boards and cards to organize tasks in a sane way. This is what the make.wordpress.com/marketing team uses for example: https://trello.com/b/8UGHVBu8/wp-marketing. board etc and which people to 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.” if they have questions.

@Kenshino gives the suggestion to create a P2 post, so we can set expectations and deadlines for people.

HelpHub

The plugin has been activated in several sites, but we are still waiting for content import into the sites. There is still not an estimation of its availability.

Next meeting & WCUS Contributor Day

We are going to be at WCUS 2019 Contributor Day, and @milana_cap has published a post about it: https://make.wordpress.org/docs/2019/10/28/docs-team-at-wcus-2019-contributor-day/

As we are going to be with limited resources next week, so the meeting has been canceled, and we will just have a meeting again on Nov 11 which will be hosted by @tomf.

Transcript

You can take a look at the meeting transcript via this link: https://wordpress.slack.com/archives/C02RP4WU5/p1572274864247300