Proposal for GitHub Process Updates

Welcome

The WordPress Training Team helps people learn to use, extend, and contribute to WordPress through learn.wordpress.org.

Are you new to the team?

Getting Started – Join the team through this self-guided onboarding program.

Current Focus Areas – What we’re currently focusing on.

Goals for 2024– the goals include the team’s vision, values, and a quarterly breakdown of project milestones.

Already onboarded and ready to get involved?

See How we use GitHub to get started on one of our 6 project boards

Meetings (Calendar)

Weekly Global team meeting: Thursdays 00:00 UTC

Dev-squad 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/ triage: Biweekly on Thursdays 07:00 UTC

See Meeting Details for more information.

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 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/ 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:

Subject Matter Experts vet topic ideas for accuracy, relevance, and priority
Vetted topic ideas are then added to the board’s Ready to Create column
The Training Team selects 5-10 Ready to Create items during the sprint planning meeting and adds the sprint milestone to the selected issues
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
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
Once the content is in the Reviews in Progress column, an Editor (Faculty or Training Team member) reviews the content
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 CategoryCategory The 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging. (Ex. PHPPHP PHP (recursive acronym for PHP: Hypertext Preprocessor) is a widely-used open source general-purpose scripting language that is especially suited for web development and can be embedded into HTML. http://php.net/manual/en/intro-whatis.php., GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/, BlockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. 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:

GitHub specific sections in the How We Work Together handbook page
Using GitHub
How to Submit a Lesson Plan Idea
Faculty Member Getting Started Guide
Submission and Vetting
How to Submit a Lesson Plan Idea

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.

Hauwa Abashiya 10:39 am on September 9, 2022

@piyopiyofox I would advise giving folks in the training team at least a week to provide comments. Given that we’ve got WCUS I don’t think anyone will see this until after they come back.
- Courtney Robertson 1:53 pm on September 11, 2022
  
  Can confirm. I am just now taking a quick peak, but will not have time to actually review this due to WCUS and won’t have time to review until I travel home. Roughly 9/15, and that might be early for WCUS attendees.
  
  I would like to document the team expectations on intiatives and how long we stay open for a Request for Comments and the decision-making process after that occurs. It definitely needs to be reasonable turn-around for contributors to consider.
  - Destiny Kanno 1:20 am on September 12, 2022
    
    @courane01 @azhiyadev, great points! I’ve extended the feedback deadline to Friday, September 16th.
Courtney Robertson 11:16 am on September 16, 2022

During WCUS @wpscholar began work on adding views to the 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/ workflows and connected with @iandunn around the work happening to track contributions. Please read through these updates:

https://wordpress.slack.com/archives/C02RW657Q/p1663176061904429

Considerable efforts are needed by (any) instructional designer with a professional background in education/corporate training to review materials for learning outcomes. I don’t see this reflect above. The concern is that we are creating training materials with a goal for certifications, so this is foundational work to the team.

Can you clarify any workflow steps that you are suggesting we remove?
- Jamie 7:39 am on September 20, 2022
  
  How will the subject matter experts be notified there are new topics to review?
  
  The issue with 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/ discussions is the same issue most forums have. It’s hard to extract information out of that. It would seem that the initial discussion could be with the forums, but would need to then be summarized into a usable format.
  - Courtney Robertson 5:33 pm on September 20, 2022
    
    Similar to views: https://github.com/orgs/WordPress/projects/33/views/8.
    
    We can use 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/’s teams features to tag in SMEs as a group w/in GitHub and also make a view of issues we need their attention on.
    
    See teams at https://github.com/orgs/WordPress/teams. We can create a team for SMEs that will 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.” them in to issues when they are ready for feedback.
    - Destiny Kanno 3:19 am on September 21, 2022
      
      We can create a team for SMEs that will 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.” them in to issues when they are ready for feedback.
      
      That is definitely doable!
    - Destiny Kanno 8:10 am on September 22, 2022
      
      We can use 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/’s teams features to tag in SMEs as a group w/in GitHub and also make a view of issues we need their attention on.
      
      See teams at https://github.com/orgs/WordPress/teams. We can create a team for SMEs that will 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.” them in to issues when they are ready for feedback.
      
      Thinking about this a bit more, I think it may be easier to utilize the “Needs SME Review” label and create a new view for SMEs to monitor. This removes the need for onboarding / offboarding to a new GitHub group.
      
      Thoughts?
Destiny Kanno 9:45 am on September 22, 2022

Thank you for your feedback everyone– I’ve collated the feedback and started a draft for a project thread for review here https://docs.google.com/document/d/1-Z8F34xUeyFjkjQf0mzEP1YTJ8jCX6ZViAwZ59IgFsU/edit#.

Please review and let me know if we need any additional tasks or edits to them.

Cheers!
- Benjamin Evans 7:59 am on September 28, 2022
  
  Thanks for the doc! I’ve added another item under documentation.