How We Work Together

The Training Team has three main places where discussions take place.

  1. Team blog https://make.wordpress.org/training/
    • This is the team’s public facing discussion place. All decisions should be discussed and announced in blog posts to allow the widest audience to participate. These are also indexed by search engines and leave a public record of what the Training Team has worked on through it’s history.
  2. SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. channel #training
    • This is where you can connect with other contributors in the team in real-time. It’s where you can ask Faculty members and other experienced teammates for help while working through team tasks.
    • Training team meetings are conducted in Slack. But decisions are not made in Slack. If an item needs a discussion/decision, then it should be published as a post on the team blog so that the general public can see the discussion and join in on the decision making, too.
  3. 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/ https://github.com/WordPress/Learn
    • This is where individual tasks are tracked. These include content creation, content translation, website management, etc. GitHub issues are organized into at least 6 project boards. You can read more about the Training Team’s GitHub boards in our handbook: How we use GitHub

If you’re new to the team, or don’t have access to any of the above, then come complete the Training Team’s onboarding program – Getting Started. You’ll be guided through setting up accounts, finding your area of expertise, completing your first contribution, and more in just 30-60 minutes!

Meetings

The Training Team meets weekly to connect, coordinate tasks, and review progress. Here are our meeting times:

  • Global Team Meeting: Thursdays at 00:00 UTC
  • Dev-squad GitHub Triage Session: Thursdays at 07:00 UTC

Top ↑

Meeting Details

Here is more information about how each of these meetings are conducted:

  • Global Team Meeting – 1 hour
    • Text-based meeting in the #training channel in Slack where we cover news, project updates, and other discussion topics.
    • The agenda will be created in GitHub and shared in the #training Slack channel by Monday each week.
    • Anyone can contribute to discussions asynchronously, and meeting notes will be published by the end of each week.
  • Coffee Hours – 1 hour
    • Video-based social chats. You can also attend with audio only, or via text in the Slack thread that will be created at the time of the meeting.
    • There is no formal agenda. These are designed for team members to connect with each other, and are also great opportunities to ask questions about contributing to the team.
    • The Zoom link will be shared in the #training Slack channel at the time of the meeting each week.
  • Dev-squad GitHub Triage Session – 30 minutes
    • Text-based meeting in the #meta-learn channel in Slack where we triage pull requests and issues regarding Learn WordPress website development.
    • The triage session’s focus is to help move GitHub issues forward. We will not be reviewing/verifying code, but instead reaching out to the issue submitters, helping them move their requests forward.

Top ↑

Organizing Tasks

The Training Team uses GitHub to organize tasks. For more information, see How We Use GitHub.

Top ↑

Development Workflows

We have a development workflow for our lesson plans, workshops and courses.

Top ↑

Our Lesson Plan Development Workflow

All lesson plans follow our development workflow which is outlined below. No one person is expected or should do all the steps mentioned individually.

Top ↑

Our Proposed Workshop Development Workflow

All workshops follow our workflow which is outlined below. No one person is expected or should do all the steps mentioned individually.

  • Vetted by instructional designers for content
  • Vetted by deputies for contributor reputation
  • Provide feedback of the idea
  • Lesson plan has been published
  • Workshop created
  • Workshop submitted to team for Q/A review
  • Workshop submitted to WPTV
  • Workshop published on WPTV
  • Workshop is captioned
  • Workshop created on LearnWP
  • Workshop post reviewed for grammar, spelling, etc.
  • Workshop published on LearnWP
  • Workshop announced to Training team
  • Workshop announced to creator, badge reviewed
  • Workshop announced to Marketing team for promotion
  • Gather feedback
  • Refine

Top ↑

Coming Soon: Courses

Stay tuned for this process

See our How to Guides or view our Content Development board for more detail on each step.

Top ↑

Our Repository

Our courses, workshops, lesson plans and supporting materials are written and stored in Learn WordPress.

Got an idea for a lesson plan, go to Learn WordPress.

Top ↑

Submitting Issues

If you have a theme or functionality-related issue, please submit it to https://github.com/WordPress/learn/issues/.

If you have ideas for Edit Flow functionality, please submit them to https://github.com/Automattic/Edit-Flow/issues.

For issues relating to the content of lesson plans, tutorials or courses, please use Report Content Errors and Feedback to let us know.

Last updated: