Summary for Docs Team Meeting 6th January 2020

Transcript: https://wordpress.slack.com/archives/C02RP4WU5/p1578322842026400

Facilitator and Attendance

Facilitator: @aurooba
Note-taker: @leogermani

@leogermani will be facilitating next week’s meeting.

Attendees: @aurooba, @bph@atachibana, @milana_cap, @leogermani, @pbrocks, @fierevere, @audrasjb, @kulsumsiddique, @marcio-zebedeu

Docs team organization: Workflows

@milana_cap created placeholders pages in our handbook pages at: https://make.wordpress.org/docs/handbook/workflows/

She suggests that we add a detailed workflow on how contributions are done for each project in our team, taking into account one-time contributors that only want to report an issue and dont know how the team is organized.

@leogermani says the idea is that these Workflow pages should be seen as Landing pages where the user will get when clicking on “report an error” (or something like this) wherever he/she is.

@atachibana asks if 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/. could be the main channel of communication, but @aurooba argues that this could be too much of a barrier for one-time contributors

The creation of workflows are being organized on Trello in this Card: https://trello.com/c/GNXYppYS/44-workflows

@leogermani reminds that we also discussed in the last meeting the need to update our “Current projects” page -> https://trello.com/c/11QKAfmA/45-current-projects-page

Docs team organization: Badges

There is a need to define and document how badges are handled in the team. We are waiting @kenshino get back so we can discuss it.

Helphub

About the Feedback Section: https://meta.trac.wordpress.org/ticket/4915, @bph says it should use the native comments functionality.

@milana_cap says this could be a bit hard. “development is stale because of combined repos at 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. https://github.com/ and svn. also, I have no idea in what state is staging”. She says she is going to investigate it.

Currently, Helphub uses a Custom Post TypeCustom Post Type WordPress can hold and display many different types of content. A single item of such a content is generally called a post, although post is also a specific post type. Custom Post Types gives your site the ability to have templated posts, to simplify the concept. and a Child themeChild theme A Child Theme is a customized theme based upon a Parent Theme. It’s considered best practice to create a child theme if you want to modify the CSS of your theme. https://developer.wordpress.org/themes/advanced-topics/child-themes/., and there is no support for comments in the code. This needs some development to move on.

About the Mobile Menu: https://trello.com/c/vPgNIdRT/7-creating-sub-categories-for-the-getting-started-category-in-support-docs, @atachibana says it has been discussed and now they want to ask the design team for feedback. @atachibana will add needed comments to the 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. card.

Localization

@atachibana: for Japanese HelpHub, we are migrating them (especially in the 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/. in WordCamps).

@milana_cap: I’m having problems with recruiting Serbian volunteers but we are discussing the idea of having local “Translation Day” and try to move forward

@marcio-zebedeu: the translation for the Angolan team is in progress. Soon I’ll be recruiting more people

Common APIs Handbook: i18n

@leogermani: regarding i18n pages on the commons api handbook. Last meeting we were looking for volunteers to update the Plugins Development Handbook on this matter. I dont recall if we found one

We are still looking for a volunteer to refactor the i18n pages of the Plugins Handbook

Devhub

@atachibana: @stevenlinx redirected so many Codex pages to Code Reference. Thanks.

@pbrocks says there are no updates on 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. Handbook yet.

New readme.txt file for the Developer Handbook

@Carike: New readme.txt file is currently on version 2. There will be a version 3, which will hopefully be the final version. The proposal includes new headers, so it needs thorough discussion.

More details on this subject in this trac ticket: https://core.trac.wordpress.org/ticket/48486