This team is responsible for all things documentation, including the Codex (moving to HelpHub), handbooks, developer.wordpress.org, admin help, inline docs, and other general wordsmithing across the WordPress project.

Want to get involved?

We need your help keeping content current with each WordPress release and adding new content and screenshots to:

Summary for Docs Team Meeting 15 October 2018

Attendance

Codex Migration (for DevHub)

There is a list of function, class and hook that are due for migration / redirection on a Google Sheet.

We had a good discussion around priorities for redirection (since many Codex’s code examples have been migrated already to the relevant DevHub pages) and it was decided that the priority will be setup in such a fashion:

Mirrored content – redirect all

Migrate high traffic articles (We don’t need 100% migration, there doesn’t need to be 500 examples for one functionality)

DevHub

@coffee2code has made sure that the WP Code reference now has the latest source code and documentation parsed in. This means the DevHib has up to 4.9.8’s code references recorded.

He has also added a WP-CLI command so that anyone with a sandbox can reparse the source in the future. (https://meta.trac.wordpress.org/changeset/7717)

@coffee2code was also working on the DevHub homepage revamp which looks like the wireframe here – https://meta.trac.wordpress.org/ticket/3377#comment:5 (This has already been done before the minutes were posted (late))

He’s also working on allowing users to edit their own comments (Code examples) on DevHub – https://meta.trac.wordpress.org/ticket/3572

Inline Docs

Because WordPress 5.0 is designated a Gutenberg release (mostly). It is likely the core inline doc changes won’t make it into the 5.0 release. If these changes are pushed, they will likely fall into the 5.1 release.

Docs Handbook Architecture

@milana_cap worked on recording the pages and fixed the paginations to show pages in proper order.

There still exist quite a few unfinished pages and @kenshino will take some days closer to the end of the year to write missing content

However, work to improve the Docs team handbook shouldn’t stop and volunteers are free to help improve it.

WordPress Contextual Help system

The WordPress Contextual Help system looks like this if you need help reminding (it looks like this)

The Docs team is responsible for the strings present within and we’ve not been looking at it for some time.

We’ll be slowly bringing this back into the Docs Team meeting.

We noted that the Contextual Help system is missing in Gutenberg as well.

You can view the meeting history in detail starting from https://wordpress.slack.com/archives/C02RP4WU5/p1539615616000100