Summary for Docs Team Meeting 10 June 2019

Attendance

@kenshino @atachibana @clorith @softservenet @chrisvanpatten @aurooba @ibdz @johnbillion @juliobox @seedsca

@milana_cap provided pre-meeting update.

Content MigrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies.

@atachibana reported all Phase 1 contents were migrated.

@kenshino requested a report about the status of redirection.

@atachibana reported all Phase 1, 2 and Version Text Content has been redirected as referenced on the sheet:
https://docs.google.com/spreadsheets/d/1PeHj7pSFLcdMbIC41JJdzEkl12TJT3mwWyzQv2mi01U/edit#gid=835534324

@kenshino requested an update on DevHub Redirection (ie: Codex to DevHub)

@atachibana supplied a tracking sheet and will be writing an Editing Guide for it: https://docs.google.com/spreadsheets/d/15hpEbbnuWJZ0DJafyCeG3CFRMtSxX1gY-RObrrjzzdw/edit#gid=0

@atachibana and @kenshino discussed coming up with a summary of remaining tasks as well as determining permissions for people to help at WCEU 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/..

HelpHub Development

@milana_cap was not able to attend, but supplied a Phase 1 Dev Update:

We are still waiting for any kind of response on this one https://meta.trac.wordpress.org/ticket/4267

Is there anything we should or can do to make things get a bit faster merged for HelpHub?

Asked: @clorith if he’d have some time to help push Development decisions ahead as we have the 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. Team help now.

DISCUSSION:

@ibdz proposed a design related to ticket 4267
*with the below suggestions
https://github.com/WordPress/HelpHub/issues/245

-SidebarSidebar A sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme. navigation for HelpHub (match DevHub and overall wp.org Meta)
-Add breadcrumb
-The right sidebar should be more selective and link to main sections (not implemented in this design yet)
-Propose the accordion solution for “For devs” section

@kenshino asked the status of this proposal and it was discussed that this would be looked at during WCEU and that the Design Team may also have some input.

@ibdz said that we can do the patch for now, according to the latest update design in About page.

GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/ Handbook

@chrisvanpatten reported he is working on moving over to the `wp/` branch and cleaning up some of the code on the Gutenberg side and that he feels other than the backend docs infrastructure cleanup, the handbook content itself is “stable” at this point.

He invited anyone that has documentation ideas or requests, or want visibility on existing ideas, to feel free to create or comment on GitHubGitHub GitHub is a website that offers online implementation of git repositories that can 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/.

@kenshino thanked @chrisvanpatten and Contributors for their work and detail of the documentation and both confirmed that this should now be able to be moved to a regular check in.

@kenshino also requested @chrisvanpatten supply a list of those who worked on the project so that they can be assigned Contributor and Team badges.

Best use of the More Info field on DevHub

https://make.wordpress.org/docs/2019/05/13/the-best-way-to-use-the-more-info-section/

@kenshino commented about there being some notes about how to utilize this and asked @juliobox to map out his ideas on how to move ahead and move into giving him access to try working with these for a period of time and then look back for feedback. @juliobox expressed willingness to moderate the user_notes.

@aurooba has notes from when the conversation originally came up and will add them to the comments so that @juliobox can use these for his mapping of ideas.

Centralised APIAPI An API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways. Handbook on DevHub

https://meta.trac.wordpress.org/ticket/4376

@kenshino stated we just need to agree to work on it and would if there were no objections forthcoming with the ticket.

Google Season of Docs

@kenshino reported that we did not end up participating in this for two main reasons:

1. Everyone who would want to participate needed to submit their own applications, and we couldn’t get it done in time.
2. We couldn’t find two people willing to act as the financial contacts.

*we’ll try again next time keeping this in mind, with more time

Who’s in Docs Team

@kenshino asked for people to volunteer for the draft list of Docs Team positions:

Docs Team Lead
• HelpHub Development Lead
• Content Lead
• User Notes (DevHub) Curator
• Theme Handbook Lead
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 Lead
• More Info (DevHub) Curator
• Regular Contributor
• Design Lead

Even if currently holding the position, either DM @kenshino to re-volunteer for it or reply to the notes from this meeting.

He also asked that all people with Key Positions in the Team to go through the training @chanthaboune is proposing:
https://make.wordpress.org/updates/2019/06/03/team-lead-interest-post/

@clorith mentioned input is being solicited (for another week) on the team lead documents linked in the above post and everyone is welcome to provide input, or to voice their interest and take part.

Open Floor

@ibdz brought up the responsive table pattern (mobile) for HelpHub:
https://github.com/WordPress/HelpHub/issues/246

@kenshino asked @ibdz to determine who approves the designs and to advise and asked everyone to comment on the designs done by @ibdz