Summary for Docs Team Meeting June 29, 2021


Housekeeping

Attendance

@milana_cap, @ashiquzzaman,  @atachibana, @mburridge @mkaz,  @femKreations, @tacitonic, @kmhazari @chaion07, @joyously @themiked, @manzwebdesigns 

Where: #docs channel on Slack

Find the complete Transcript of the meeting on Slack.

Meeting Facilitator: @ashiquzzaman

Note Taker: @femKreations

Next Meeting Facilitator: No volunteers found for facilitation of next week’s meeting. Volunteer over #docs Slack if you can do this.

Project Updates

Doc update for 5.8 update release

Update from @milana_cap:  WordPress 5.8 release cycle today enters Release Candidate 1 phase. This means that all dev notes and field guides should be published today (June 29, 2021). Once that’s done the doc team will move on to updating DevHub and HelpHub. @femKreations is currently working on the HelpHub updates, hence a lot of HelpHub is ready.

The doc team also has a new plugin activated at HelpHub and DevHub, which allows the documentation team to edit already published posts and pages and schedule changes for later date while existing content is intact.

Update from @tacitonic:  No new updates for the Style Guide. Currently working on the article for C.

New Member Mentoring

Update from @chaion07:  A schedule is being prepared to support the onboarding of new members. A link to the form will be shared in a blog post (P2) for the convenience of everyone. The team is aiming to start in early July.

Monthly Coffee Break: Also for Docs Coffee Break The team is unlikely to have one for June due to the unavailability of core members and a lot of contributors struggling to find time due to COVID.

@mburridge will be working with @chaion07 for guidance and mentoring to get started with contributing to the docs team.

Audit Tool Proposal Update (proposed by the Training Team)

@courane01 and @milana_cap have a meeting scheduled on Friday, July 2. 2021 to review how the docs audit HelpHub/DevHub currently and collect the feature requests for the audit plugin/tool. Also to be determined what in the tool would benefit the docs workflows.

DevHub & HelpHub updates

@justinahinon’s raised few questions on DevHub:

  • Is there a reason why the WordPress.org API documentation is hosted on Codex (https://codex.wordpress.org/WordPress.org_API), and not on DevHub?
  • It seems like WordPress.org API documentation could benefit from some improvements, by adding examples, use cases, and endpoints, for example. But it also seems like some of these are intentionally not documented because they are not meant to be used by third parties. Is this the case, and if yes, where should we look to find what should not be documented?

@milana_cap suggested discussing this with the #meta team and see if there’s a good place for such documentation.@atachibana suggested Common API Handbooks to add the WordPress.org API documentation. @milana_cap and @atachibana agreed that adding the WordPress.org API documentation to the Common API Handbooks would be confusing.

@femKreations will continue working on the HelpHub

Doc Team is looking for Block Editor End User Docs Project Lead. @mburridge has shown interest and would consider the role after onboarding.

Update from @milana_cap The categorization of support articles is still in progress. @estelaris is working on the site search and it will be done soon.

Open Floor

@joyously asked about the categorization of support articles?

@milana_cap commented that it’s still in progress.

#meeting-notes