Triaging Content Development Issues

The Training Team manages content development in the LearnWP Content – Development GitHubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/ project board. This is where content and feedback are passed between Content Creators and Editors before content is finally published on https://learn.wordpress.org/.

Project board overview

Issues in this project board pass through 5 columns, or statuses, as progress is made.

General contributors do not have access to add/delete labels, set custom fields, or move issues between columns/statuses. Faculty Members need to check each issue and manually move them between statuses on behalf of contributors.

Column nameReady to CreateDrafts in ProgressReviews in ProgressPreparing to PublishPublished or Closed
Issue detailsIssues have been vetted and relevant labels have been added.Issues being worked on by a Content Creator.Content waiting for reviews.Content has been reviewed and is in the final stages before being published.Completed issues.
Issues moves to the next column when…A Content Creator has commented on the issue, volunteering to create it. An Admin has confirmed the volunteer has necessary access to create the content on Learn.A Content Creator has attached the created piece of content.A piece of content has received three reviews.The content has been published
Next destination“Drafts in Progress” column“Reviews in Progress” column“Preparing to Publish” column“Published or Closed” column

Top ↑

Triage Tasks

Triaging is when a Training Team member checks through each column of the project board to assess the progress and status of issues. Triaging ensures that contributors are assigned, unblocked and enabled for the issues they are responsible for. This work also ensures that the Training Team meets their content creation goals by working to guide tasks to completion.

A GitHub triage can be performed at any time by Administrator Faculty Members or Training Team Representatives. Follow the steps below to triage issues in each status.

Top ↑

Issues in “Ready to Create”

  • Make sure the correct content creation checklist is applied to the issue
  • 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.” @faculty-content-creators to see if any Faculty Content Creators have capacity to create the content; alternatively, ping specific Content Creators for issues based on their expertise

Top ↑

Issues in “Drafts in Progress”

  • Check in to see if the Content Creator needs any unblocking or assistance.

Top ↑

Issues in “Review in Progress”

  • If the content has not been reviewed yet, ping @faculty-editors to see if any Faculty Editors have capacity to pick up the review; alternatively, ping specific Editors for issues based on their expertise.
  • All content requires three reviews. These can be counted by adjusting the Review Stage custom fieldCustom Field Custom Field, also referred to as post meta, is a feature in WordPress. It allows users to add additional information when writing a post, eg contributors’ names, auth. WordPress stores this information as metadata. Users can display this meta data by using template tags in their WordPress themes..
    • An exception is if a piece of content has been waiting for reviews for two weeks. If so, then the content can be published even if it hasn’t received three reviews.
  • Once all reviews are complete, or a piece of content has been in “Ready for Review” for two weeks, then a Training Team RepTeam Rep A Team Rep is a person who represents the Make WordPress team to the rest of the project, make sure issues are raised and addressed as needed, and coordinates cross-team efforts. or Faculty Member can publish the content on Learn WordPress.

Top ↑

Issues in “Preparing to Publish”

  • If an issue has been in this status for more than two weeks, see if the Content Creator needs any assistance to publish the content.

Top ↑

Issues in “Published or Closed”

  • Make sure that the Content Creator has properly publicized their content by announcing it:
    • to the Content Creator
    • to Marketing
  • In accordance with WordPress update releases, flag any out of date content with the Revisions Needed label and moving it back to the Ready to Create column.

Last updated: