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 Day

@Kenshino will ping the Theme Review Team for a review of the handbook.

Codex Migration (DevHub)

@drewapicture has been busy with WordCamp 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 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