Content type: Handbook

  • Documentation team profile badge

    Like many other Make teams, the Documentation team has two different badges: for Contributors and for Team members. Each team defines their own set of criteria for awarding badges. Who decides whether a badge is “earned” or not? The Documentation team has several active projects, led by different people. These people know the effort behind…

  • Facilitating the Documentation table at Contributor Day

    Facilitating the Documentation table at Contributor Day means helping contributors understand what the Documentation Team does, guiding them toward suitable tasks, answering questions throughout the day, and making sure their contributions are recorded for follow-up and recognition. Before Contributor Day Before the event, prepare to help both new and experienced contributors get started quickly. Review…

  • Facilitating weekly meetings

    Docs team meets once a week in WordPress #docs Slack channel. These meetings are used for short updates on current projects’ updates and discussions on current issues/problems/suggestions.  Meetings require:  Meeting agenda – published on Docs team’s blog prior to the meeting. Facilitator – person who facilitates meetings. Notes – published on Docs team’s blog after…

  • Reporting an issue

    The Documentation team is in charge of several different projects across WordPress.org. These projects use different tools for contributing, and therefore, the workflow for reporting an issue varies depending on the project. This page is mainly for one-time and first time contributors. So, if you are just starting contributing to the Documentation team or you…

  • Workflows

    In this section we’ll try to explain various Documentation team workflows. We’ll cover scenarios from reporting a single issue as a one-time contributor, to fixing issues, facilitating weekly meetings and Documentation team table at Contributor Days.

  • Projects to Translate

    The WordPress project has a near-infinite number of translation projects, thanks to the inclusion  of plugins and themes in translate.wordpress.org. For new locale teams, and even experienced locale teams, it can be difficult to know which projects to focus on to make the best use of your time. This guide includes some suggested projects, which…

  • Writing a post

    Should you wish to write a post on make/design there are a few things to go through. Asking to post Usually, you will be an active contributor to the team and collaborate at least first with a team rep. Should you wish to write a post here are the steps: Reach out in #design or…

  • Documenting a focus

    Preparing To start let’s look at some examples which could fall into ‘Focus’: A11y color/styling work for 5.3 Full site editing: as this starts to happen Writing Create a new page for the focus and link under handbook section ‘focus’. In that page have: Title of that focus. A description. Who is currently working on…

  • Current Focuses

    A focus is a project that normally takes more time and likely includes multiple people and/or teams. Currently, focuses for design revolve around release roadmap posts and their subsequent projects, alongside scoping out Phase 3 efforts. Design Priorities Projects There are a range of project boards you can use to look at priorities in the…

  • WordPress components

    What are they? WordPress Components are the set of interface elements that make up the Block Editor and other projects. This includes several user interface (UI) components like buttons, menus, and text fields. You can find them in the Gutenberg GitHub repo or in the Block Editor Handbook. The code for these components exists in…