DocsWP — WordPress Help

Proposal for GitHub Process Updates

Overview

Based on the discussions during the August 24th / 30th Supplemental SME Meeting and recent Monthly Faculty Meeting, folks have requested changes to the GitHub Content Development Board’s issue triaging and management. This proposal offers improvement suggestions to the current GitHub processes in order to clarify workflows for Faculty and Training Team Members.

General Workflow suggestions

Outlined below is a workflow that folks would like to try going forward:

  1. Subject Matter Experts vet topic ideas for accuracy, relevance, and priority
  2. Vetted topic ideas are then added to the board’s Ready to Create column
  3. The Training Team selects 5-10 Ready to Create items during the sprint planning meeting and adds the sprint milestone to the selected issues 
  4. A Content Creator (Faculty or Training Team member) picks up a task from the Ready to Create column, moves it to the Drafts in Progress column, and creates the content
  5. The Subject Matter Expert who vetted the topic or is an expert in the topic provides guidance / mentorship to the Content Creator as the content is being created
  6. Once the content is in the Reviews in Progress column, an Editor (Faculty or Training Team member) reviews the content
  7. Content is published!

In order to make the above workflow successful, the following additional updates to the GitHub workflow should be considered:

  • Creation of a new project board or utilization of the Discussions GitHub feature to receive new Topic Ideas and vet them ahead of creating GitHub issues for the Content Development project board
  • Creation of new labels:
    • Needs SME review
    • Content Category (Ex. PHP, Gutenberg, Block Theme)
  • Adopt sprint milestones
  • Have Faculty Administrators check in on issues in progress
  • Create a Topic Idea template

Handbook pages requiring updates

The following handbook pages should be updated with the above proposed changes:

What’s next?

Please comment to share your thoughts on the proposed changes above by Friday September 16th. Once the team is in agreement, we can move to create action items by Monday, September 19th.