Milana Cap 8:00 am on June 13, 2022  

Onboarding to Documentation team

Note: If you contributed to the Documentation team, please submit the form on the right 👉
Thank you for contributing 🍪🍪🍪

Here is some quick info you need in order to start contributing to Documentation team.

Accounts:

Places:

  • Blog – for meeting agendas and summaries (and anything related to Docs team).
  • Slack channel #docs – where meetings are happening (and all communication regarding the team itself).
  • GitHub repository – where issues for all documentation are reported, discussed and worked on.
  • Handbook – how to contribute to the Documentation team (it’s a bit out of date).
  • Style guide – for how to write WordPress documentation.

Meetings (alternating every week) on Tuesdays at 2PM UTC:

  • Regular meeting with agenda published on our blog.
  • Issues triage where we discuss issues from 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/ repository.

Live onboarding sessions

We recorded onboarding sessions for everyone interested in getting started with the Documentation team. We know that our “Getting started” documentation is out of date and getting involved can be very confusing and frustrating so we hope to ease the process with these sessions.

Overview

Recording: https://wordpress.tv/2022/06/21/milana-cap-overview-onboarding-for-wordpress-documentation-team/

A more recent onboarding session, recorded on 28th July 2023, can be found here: https://wordpress.tv/2023/08/01/jenni-mckinnon-milana-cap-wordpress-documentation-team-onboarding-july-2023/

End user documentation

Developer documentation

Developer documentation – PluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party handbook

Developer documentation – Common APIs handbook

Developer documentation – Code reference handbook

Developer documentation – 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. editor handbook

Developer documentation – Themes handbook

Contributor documentation – Documentation team handbook

Github related roles

If you have any questions or you’d like to have an “in more detail” session, feel free to leave the comment below.

Milana Cap 3:16 pm on February 9, 2026
Tags: ,   

X-post: Documentation Team Update – February 9, 2026

X-comment from +make.wordpress.org/updates: Comment on Documentation Team Update – February 9, 2026

Milana Cap 3:05 pm on February 9, 2026  

Documentation team meeting notes – February 3, 2026

Housekeeping

Find the complete Transcript of the meeting on Slack.

Next meeting:

  1. Where: #docs channel on Slack
  2. When: Tuesday, February 10 2026, 2PM UTC

Project updates

The team is exploring the idea of contributors submitting their contributions via a form in the Docs team’s blog sidebarSidebar A sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme.. However, as with any form, we are facing a lot of spam submissions. The workflow in 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/. is another option, but only few in Slack can create those.

@estelaris posted How to help with the overhaul of documentation issue tracker in GitHub. She is still working on the audit, but we might as well begin updating documentation.

@milana_cap is actively working on a proposal for gamifying contributions.

Proposal for Gamifying Docs contributions

The team rewieved proposal draft and left valuable feedback. @supernovia noted that new contributors might feel intimidated by the low likelihood of “win”.

As the purpose of gamification is to encourage new contributors to start contributing, as well as trying out different ways of contributing to the Docs team, in order to find what suits them the best, the proposal is going to be modified as follows:

  • The most points will be added for “getting started” tasks,
  • Special bonus points will be added for doing the type of task for the first time,
  • Achievements will be reflected in 2 ways: total points and/or title pathway,
  • Once the contributor earns a team membership, competition stops for them, and they are considered to have reached the game finish line.

@estelaris offers her mentorship to anyone interested in becoming a team member ❤️

#docs, #meeting, #summary

Milana Cap 1:32 pm on February 3, 2026
Tags: , ,   

Agenda for Discussion Meeting September 16, 2025

The meeting is scheduled with the following details:

When: Tuesday, February 3, 2026, 14:00 UTC

Where: #docs channel on Slack

Agenda:

  1. Attendance.
  2. Note-taker and facilitator selection for the next docs team meeting.
  3. Project check.
  4. Proposal for Gamifying Docs contributions draft
  5. Open floor.

If there’s anything you’d like to discuss on the open floor, please leave a comment.

#agenda, #docs, #meetings

Estela Rueda 3:59 pm on February 2, 2026  

How to help with the overhaul of documentation issue tracker in GitHub

While writing and updating HelpHub articles for 6.9, the team discovered that many articles have not been updated making it difficult to maintain the quality of the documentation. For this reason, the team is incurring in an overhaul of the documentation with 3 main goals:

  1. Improve the quality of the documentation.
  2. Use the changelog to recognise contributors.
  3. Update the blocks articles before WP 7.0 is released.

What is the overhaul and how it works

A project has been created in 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/ for each of the categories plus the blocks – see links below. In each categoryCategory The 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging. there is a READ FIRST issue with instructions.

Basically, a new issue is open per 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./feature with the title “Overhaul XX block documentation”.  Look at the related open issues, see what’s still useful, and close anything that’s ancient/irrelevant. For other details, follow the instructions in the READ FIRST article.

Key things to remember:

  1. Self-assign the issue you decide to tackle.
  2. Close those outdated issues! Don’t let them hang around.
  3. Write your final updates in the comments first, before you update the actual article in WordPress.
  4. Need to edit the docs site? 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.” @estelaris or @milana_cap for access.
  5. Don’t forget the contributors! Add anyone who suggested something (even if you don’t use it) to the changelog. You only need to contribute once to become a Docs contributor!
  6. If you can’t figure out a contributor’s WordPress username, just ask in the 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/. docs channel.
  7. Note: if there is only one issue open  for a feature/block, only the title has been edited to add the word “Overhaul”. This is done to avoid extra issues and extra work.

The list of the overhaul projects in GitHub:

Note: the audit on the GH docs issue tracker is still happening, thus projects below will be updated as soon as possible.

Props to @milana_cap and @mosescursor for reviewing this post.

Milana Cap 11:03 am on February 2, 2026
Tags: ,   

X-post: Documentation Team Update – February 2, 2026

X-comment from +make.wordpress.org/updates: Comment on Documentation Team Update – February 2, 2026

Jonathan Desrosiers 8:18 am on February 1, 2026
Tags: ,   

X-post: AI Guidelines for WordPress

X-comment from +make.wordpress.org/ai: Comment on AI Guidelines for WordPress

Milana Cap 6:16 pm on January 12, 2026
Tags: ,   

X-post: Documentation Team Update – January 12, 2025

X-comment from +make.wordpress.org/updates: Comment on Documentation Team Update – January 12, 2025

Jonathan Desrosiers 2:13 pm on December 19, 2025
Tags: ,   

X-post: WordPress 6.9 Release Retrospective

X-comment from +make.wordpress.org/core: Comment on WordPress 6.9 Release Retrospective

Jonathan Desrosiers 9:43 pm on December 18, 2025
Tags: ,   

X-post: Proposal: 2026 Major Release Schedule

X-comment from +make.wordpress.org/project: Comment on Proposal: 2026 Major Release Schedule

Estela Rueda 4:11 pm on December 18, 2025  

Docs meeting notes Dec. 16, 2025

Housekeeping

Find the complete Transcript of the meeting on Slack.

Next meeting:

  1. Where: #docs channel on Slack
  2. When: Tuesday, January 13, 2026 14:00 UTC

Project updates

@milana_cap informed the team that there will be a holiday break and docs team will reinitiate activities on the 13 of January 2026 at 14:00 UTC.

@milana_cap also let the team know that next year, there will be a new gamification contribution system, where contributors can collect points for every single contribution, from attending the meeting to writing articles, documenting releases and leading docs tables at Contributor Days. There will also be special titles, leader board, and points could be deducted. More information will be posted in the Make blog in January.

@estelaris closed as “not planned” 60 issues related to the mobile app. For the time being there is no one to take ownership of this project. Perhaps in the future, the project could be reopened. https://github.com/orgs/WordPress/projects/89/views/1

A new project to overhaul the blocks documentation is starting. The goal is to update the 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. articles before WP 7.0 is release and fix any outdated information, broken links, broken images, etc. Instructions will be up in the upcoming weeks. https://github.com/orgs/WordPress/projects/267/views/1

@tobifjellner, a global mentor for the polyglots teamPolyglots Team Polyglots Team is a group of multilingual translators who work on translating plugins, themes, documentation, and front-facing marketing copy. https://make.wordpress.org/polyglots/teams/. joined, he is interested in understanding the documentation workflow to continue the translation project. Docs contributors interested in translating documentation are invited to join the #polyglots-multilingual-community

Previous work has been done in the documentation translation project, read the notes from the last meeting in WCEU 2024 in Torino.

#docs, #meeting, #summary