Summary for Documentation Team Meeting Nov 3

Attendance

@drewapicture @Kenshino @adamsilverstein @kadamwhite @chopinbach

Theme Developer Handbook

The handbook’s progress is going well and will probably see an official release after WCUS. Current focus is put on the existing tasks and version 1 of the TDH will not include any of WordPress 4.7 changes.

A feedback mechanism needs to be in-place for the handbooks. This is possibly a point for discussion at WCUS 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/.

@Kenshino will 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.” the Theme Review Team for a review of the handbook.

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

@drewapicture has been busy with WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. Denver and US. As most of the work for Codex Migration boils down to tedious manual information transfer, this is likely a good task for new contributors to work on on a Contributor Day.

DevHub

A substantial discussion hovered around how the REST APIREST API The REST API is an acronym for the RESTful Application Program Interface (API) that uses HTTP requests to GET, PUT, POST and DELETE data. It is how the front end of an application (think “phone app” or “website”) can communicate with the data store (think “database” or “file system”) https://developer.wordpress.org/rest-api/. docs would settle into DevHub.

2 key steps have been identified

  1. REST API explanation and examples should be placed in a new REST handbook.
  2. Actual functional reference should be built into the inline-docs.

All these needs to happen before WCUS as WordPress 4.7 will be released right after.

@drewapicture will organise a separate project meeting for this endeavor early next week to create a cohesive plan going forward.

Helphub

The development of Helphub has slowed down considerably due to end of year work commitments that many team members have.

Migration has been fully done and editing will take some time (but is a non-blocker)

Development – Needed functions are in but it’s rough and requires a fair bit of refinement.

Design – The original 2 project designers have been busy and @krogsgard has just joined us to help define the design needs going forward. We will seek additional support from the #design team very soon.

Inline Docs

A huge ticket that covered improving docs for REST endpoints was solved and merged.

Going forward, the 4.7 docs audit is currently the focus.

Open floor

Documentation Team meetings are changed to a biweekly schedule. The next meeting is NOT next week. It’s on 17 Nov.

Project meetings will happen as and when scheduled.

Read the meeting transcript in the Slack archives. (A Slack account is required)

#summary