How we use GitHub

The Training Team uses GitHub repository https://github.com/WordPress/Learn to manage all of the following:

  • The code for https://learn.wordpress.org
  • Issues tracking content development for Learn WordPress
  • Issues tracking content translation for Learn WordPress
  • Issues tracking content topic ideas for Learn WordPress
  • Issues tracking admin tasks of the Training Team
  • Learn WordPress site bugs, content feedback, and other communication from learners

The team does this by maintaining 6 project boards, described below:

Project board namePrimary contributors
LearnWP Topic VettingSubject Matter Experts (SMEs)
LearnWP Content – DevelopmentContent Creators, Editors
LearnWP Content – LocalizationContent Translators
LearnWP Content – FeedbackEditors
LearnWP Website DevelopmentAdministrators (dev-squad), Make WordPress MetaMeta Meta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress. team
Training Team AdministrationAdministrators, Team Reps

Each project has columns which represent the statuses issues move through. Each project board also has views which can be used to filterFilter Filters are one of the two types of Hooks https://codex.wordpress.org/Plugin_API/Hooks. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output. issues by labels etc. (Example: a view from the Content Development project board)

If you would like to get involved with any of these projects, head over to the Training Team’s Onboarding Program. This will walk you through creating a 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/ account and contributing to a project of your choice.

The remainder of this page lists GitHub triage activities needed to keep the Training Team’s GitHub repository nice and tidy. Please note, the following tasks can only be completed by members of the Learn Content Triage team. All Faculty members should be a member of this team. (If you are a member, you’ll see the list of members on this private page.)

If you are not a Faculty member but are interested in assisting with keeping the Training Team’s GitHub repository triaged, consider joining the Faculty Program as a Faculty Administrator 😀

Assign issues to project boards

GitHub Workflows have been set up so that most issues are added to the respective project board when created with an issue template. However, if a template was not used, then the issue will not be added to a project board, and will fall through the regular triage flows. The triage team should confirm all issues are assigned to a project board so that they are included in the respective triage process.

To do: If any issue appears under here, assign it to a project board.

Top ↑

Triaging project boards

Below are details about triaging the team’s 6 GitHub project boards.

Top ↑

LearnWP Topic Vetting

Project board: LearnWP Topic Vetting

Documentation: See Vetting Topic Ideas. As SMEs also work in this project board, triaging should focus on the following tasks:

Top ↑

LearnWP Content – Development

Project board: LearnWP Content – Development

Documentation: Triaging content development issues.

Top ↑

LearnWP Content – Feedback

Project board: LearnWP Content – Feedback

Documentation: Validating and Triaging Content Feedback.

Top ↑

LearnWP Content – Localization

Project board: LearnWP Content – Localization

Documentation: Triaging content localization issues.

Top ↑

Training Team Administration

Project board: Training Team Administration

Documentation: Still to be created.

Top ↑

LearnWP Website Development

Project board: LearnWP Website Development

Documentation: Still to be created.

Last updated: