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 by 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.

Andrea Roenning 2:06 pm on May 27, 2026
Tags: , ,   

Documentation team meeting notes – May 26, 2026

Where: #docs channel on 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/
When: Tuesday, May 26, 2026, 14:00 UTC
Meeting Facilitator: @estelaris
Note Taker: @awetz583
Find the complete meeting on Slack.

Next Meetings

Note: There will not be a meeting on Tuesday, June 2, 2026, 14:00 UTC due to WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. Europe (WCEU) travel.

Planning Meeting

Where: #docs channel on Slack + Video call
When: Tuesday, June 9, 2026, 14:00 UTC

Discussion Meeting

Where: #docs channel on Slack
When: Tuesday, June 16, 2026, 14:00 UTC

View upcoming dates on the Documentation Team meeting calendar.

Updates

7.0 Release updates

  • Documentation Progress: Content updates for WordPress 7.0 are underway. @kjoyner and @awetz583, have been added as noteworthy contributors for this release and will continue drafting content for review.
  • What’s New Post: @estelaris is working on a public post highlighting the key changes in the 7.0 release.
    • Versions Documentation: The WordPress Versions documentation page has been reordered (from newest to oldest) and split into two separate pages for easier editing and readability.
    • Advanced Settings Page: A new Advanced Settings page is being created. Most 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. article pages will need to be updated to link to this new resource (see Issue #2287).

WordCamp Europe (WCEU)

  • Event Details: WCEU Contributor Day is taking place on June 4, 2026. @estelaris and @milana_cap will be on-site to mentor and guide contributors.
  • Available Tasks: There are plenty of specific open issues ready for contributors.
  • Good First Issue: A great entry-level task for new contributors will be auditing the WordPress dashboard to map out where documentation links currently exist and brainstorm ways to improve navigation.

Documentation structure improvement proposals

@estelaris discussed a broader initiative to improve overall documentation structure. Key discussion points included:

  • Editor Integration: Exploring the ability to link directly from the WordPress editor UIUI UI is an acronym for User Interface - the layout of the page the user interacts with. Think ‘how are they doing that’ and less about what they are doing. to specific block documentation.
  • Dashboard Links: Providing clear internal links to DevHub, HelpHub, and Learn WordPress sites from within the WordPress admin dashboard.
  • FAQ Revamp: Redesigning and updating the current FAQ section.
  • Support vs. Documentation: The team addressed a common user confusion where documentation forms are mistaken for human support channels. Discussion focused on updating the copy to clearly distinguish static documentation from human help resources (like the support forums).

Profile Badges & Contributor Pathways

  • Contribution Badges: @estelaris has awarded profile badges to contributors from recent contributor days and WordCamp Asia. The team noted the new profile page layout, which now displays the specific dates badges were awarded.
  • Pathways Updates:  @supernovia reported that @marutim is currently testing the File a Documentation Issue pathway and providing feedback.
    • @clk87 is actively working on pathways and other documentation issues asynchronously due to timezone differences.

Handbook Translation Updates

  • Spanish Translation Review: @estelaris is updating the handbook based on recent work by a WP Credits student. After translating the material to Spanish and back-translating to English, the team identified several areas for phrasing and clarity improvements.

Standardizing Block Pages

The team is focusing on a systematic, content-first approach to update block documentation and reduce redundancy.

  • Consolidation: @kjoyner identified repetitive settings across various block documents. @estelaris confirmed the team is creating standardized “Advanced Settings” pages to consolidate these.
  • Toolbar Settings: @kjoyner will conduct a comprehensive review of repeated settings and open a proposal issue to consolidate common block toolbar documentation.
  • How to Propose Changes:
    • Create one issue focusing exclusively on one setting.
    • Include a checklist of all the block articles that need to be updated.

Tracking 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/ Releases

  • CoreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. Focus Only: @estelaris proposed that when tracking Gutenberg releases for upcoming block article updates, the team should focus strictly on existing core blocks and avoid documenting experimental features.
  • Version Mapping: To check which Gutenberg versions map to specific WP Core releases, contributors should reference the Block Editor Handbook Contributor Guide.
  • Testing Tip: @milana_cap suggested using WordPress Playground as a fast, frictionless way to verify current block features and ensure documentation accuracy.

Training presentation: WP Latin America

@estelaris is designing a documentation training meetupMeetup All local/regional gatherings that are officially a part of the WordPress world but are not WordCamps are organized through https://www.meetup.com/. A meetup is typically a chance for local WordPress users to get together and share new ideas and seek help from one another. Searching for ‘WordPress’ on meetup.com will help you find options in your area. tailored for Latin American communities.

  • Format: Presentation slides are being created in both English and Spanish, with the ultimate goal of publishing the recording to WP.tv.
  • Content Coverage:
    • Types of documentation in WP.org
    • The role and scope of the documentation team
    • Overview of HelpHub/DevHub
    • Docs issue workflow – from creation to solution

Schedule & Miscellaneous Updates

#docs, #meeting, #summary

Milana Cap 12:08 pm on May 25, 2026
Tags: ,   

X-post: Documentation Team Update – May 25, 2026

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

Andrea Roenning 5:09 pm on May 20, 2026
Tags: , ,   

Documentation team meeting notes – May 19, 2026

Where: #docs channel on 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/
When: Tuesday, May 19, 2026, 14:00 UTC
Meeting Facilitator: @estelaris
Note Taker: @awetz583
Find the complete meeting on Slack.

Next Meetings

Contributor DayContributor Day Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of https://make.wordpress.org/ There are many teams that people can participate in, each with a different focus. https://2017.us.wordcamp.org/contributor-day/ https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/

Where: #docs channel on Slack + Video call
When: Tuesday, May 26, 2026, 14:00 UTC

Discussion Meeting

Where: #docs channel on Slack
When: Tuesday, June 2, 2026, 14:00 UTC

View upcoming dates on the Documentation Team meeting calendar.

Updates

Documentation for 7.0 Release

See the 7.0 project board in GitHub

Contributors are finalizing documentation for the 7.0 release, with @awetz583 and @kjoyner preparing to publish changes to several blocks. @estelaris has requested that editors publish all 7.0 documentation as is, with reviews to occur during WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. Europe (WCEU) Contributor Day.

@estelaris will create the HelpHub version page for 7.0 and submit it to the release team.

WCEU volunteer and contributor engagement

@estelaris is meeting with Mary Hubbard during WCEU to discuss rethinking the process around localized contributor enablement beyond pure documentation translation, aiming to develop strategies and workflows for current and future support.

New contributor onboarding and task assignment

@estelaris confirmed that the issue identified by @mazharulrobeen is valid and offered him the opportunity to work on it as his first task. The next step is to propose solutions in a Google Doc or via issue comments for review before updating the article.

#docs, #meeting, #summary

Andrea Roenning 3:32 pm on May 12, 2026
Tags: , ,   

Documentation team meeting notes – May 12, 2026

Where: #docs channel on 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/ and on Video
When: Tuesday, May 12, 2026, 14:00 UTC
Meeting Facilitator: @estelaris
Note Taker: @awetz583

Next Meetings

Discussion Meeting

Where: #docs channel on Slack
When: Tuesday, May 19, 2026, 14:00 UTC

Contributor DayContributor Day Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of https://make.wordpress.org/ There are many teams that people can participate in, each with a different focus. https://2017.us.wordcamp.org/contributor-day/ https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/

Where: #docs channel on Slack + Video call
When: Tuesday, May 26, 2026, 14:00 UTC

View upcoming dates on the Documentation Team meeting calendar.

Updates

7.0 planning

HelpHub documentation review project

  • Docs contributors can make changes for documentation for updates made in 6.9 and earlier and put 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 by the repository owner. https://github.com/ issues in the “In review” column for WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. Europe contributors to review.

Github project boards

Additional updates

@estelaris is working on the following priorities:

  • WordCamp Europe Prep
    • Working on post for WordCamp Europe
    • Creating issue in Github
  • Prep for documentation presentation for WordPress in LATAM MeetupMeetup All local/regional gatherings that are officially a part of the WordPress world but are not WordCamps are organized through https://www.meetup.com/. A meetup is typically a chance for local WordPress users to get together and share new ideas and seek help from one another. Searching for ‘WordPress’ on meetup.com will help you find options in your area. on 5/23
  • Review handbook by WP Credits program contributor
    • Has highlighted areas documentation could be improved
    • HelpHub should be jargon free and easy to understand for an entry level WordPress editor
  • Working on some automation for Github

Open floor

Question about badges

  • Contributor badges when someone contributes
  • Team badges are given after volunteers have worked with the team over time
    • The Team Badge indicates that the Docs team can guide others

Walk through on how to get started with documentation help:

Future Video Calls using Slack Huddles

  • @supernovia proposed using Slack Huddles for video calls going forward to reduce notes burdon going forward
  • Docs team agreed and @supernovia reached out to the 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 to set this up

Hallway Hangout for DevHub Blocks documentation

#docs, #meeting, #summary

JuanMa Garrido 3:43 pm on May 5, 2026
Tags: ,   

X-post: Proposal: Auto-generate Block Editor Handbook docs from block.json

X-comment from +make.wordpress.org/core: Comment on Proposal: Auto-generate Block Editor Handbook docs from block.json

Andrea Roenning 6:53 pm on April 21, 2026
Tags: , ,   

Documentation team meeting notes – April 21, 2026

Where: #docs channel on 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/
When: Tuesday, April 21, 2026, 14:00 UTC
Meeting Facilitator: @estelaris
Note Taker: @awetz583

Next Meetings

Contributor DayContributor Day Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of https://make.wordpress.org/ There are many teams that people can participate in, each with a different focus. https://2017.us.wordcamp.org/contributor-day/ https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/

Where: #docs channel on Slack + Video call
When: Tuesday, April 28, 2026, 14:00 UTC

Discussion Meeting

Where: #docs channel on Slack
When: Tuesday, May 5, 2026, 14:00 UTC

View upcoming dates on the Documentation Team meeting calendar.

Updates

The team has made progress on the Blocks articles overhaul project board and is shifting focus to the 7.0 Documentation project board for this week.

The Docs team is looking for help from other teams to close issues in the Documentation Issue Tracker. Read the post WordPress Documentation Team Closes 200+ Issues — and Needs Your Help for more information.

#docs, #meeting, #summary

Estela Rueda 2:38 pm on April 21, 2026
Tags:   

WordPress Documentation Team Closes 200+ Issues — and Needs Your Help

The documentation team needs help, especially from coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress., themes, and support contributors. As part of an overhaul, the Documentation Team has triaged and labeled nearly 800 issues in 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 by the repository owner. https://github.com/ documentation issue tracker, closing 200 so far. Many of the open issues belong to your teams. Find your area below, then:

  • Close stale issues that are no longer relevant, or comment “Close this” if you don’t have access
  • Comment with corrections or updated information when you spot something wrong
  • If possible, draft doc changes and comment with markdown or a link to your draft

If you have permissions to close issues or update docs directly, even better. If not, your comments are exactly what’s needed to help the docs team take action.

Here are the open issues by area:

Questions? 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 in #docs on 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/.

7.0 documentation and other projects

Besides the overhaul, the docs team is focusing on WordPress 7.0 documentation and a revision of the handbook to include the recommendations given by @rossanatrujillo, a student from the WPCredits program.

Props to @awetz583 for reviewing this article and @supernovia for clarifying

#docs

Andrea Roenning 4:14 pm on April 14, 2026
Tags: , ,   

Documentation team meeting notes – April 14, 2026

Where: #docs channel on 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/ + Video call
When: Tuesday, April 14, 2026, 14:00 UTC
Meeting Facilitator: @estelaris
Note Taker: @awetz583

Next Meetings

Discussion Meeting

Where: #docs channel on Slack
When: Tuesday, April 21, 2026, 14:00 UTC

Contributor DayContributor Day Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of https://make.wordpress.org/ There are many teams that people can participate in, each with a different focus. https://2017.us.wordcamp.org/contributor-day/ https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/

Where: #docs channel on Slack + Video call
When: Tuesday, April 28, 2026, 14:00 UTC

View upcoming dates on the Documentation Team meeting calendar.

7.0 Documentation

View the 7.0 Documentation Project board in Github

@estelaris created a Github issue for Resources for 7.0

Changes to existing documents will be drafted in Gitlab issues. For new features, we can create new pages ahead of time if we leave them in draft.

New blocks in 7.0 that will need new documentation pages:

  • Breadcrumbs 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.
  • Icon block

@aialvi will be working on adding updates to issues identified 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 by the repository owner. https://github.com/

Blocks articles overhaul project

View the Blocks articles overhaul Project board in Github

@estelaris added additional blocks to the Backlog for documentation changes and to close old issues in the Documentation Issue Tracker.

Contributors can continue to work on the cleanup tasks while we are waiting for 7.0 to be released.

@awetz583 will continue updating existing blocks including the Cover block.

It would be nice to have a full list of which blocks exist in the block editor. We have access to the block code in GitHub but not all of the blocks are currently active and not all are user-facing.

@estelaris continues work on the Block overhaul triage Spreadsheet

Documentation in some of the sections in the spreadsheet such as WP Overview @estelaris and @milana_cap will update due to access and background in the project. @estelaris has access to edit the tooltips for keywords that are driven by the glossaries. 

Dev Hub Issues

The documentation team needs Help closing DevHub issues. Please close anything related to missing documentation that was created when the parser was run.

How to get documentation badges?

@estelaris will look into the new process and ensure those who helped at WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. Asia will receive WordPress.org documentation profile badges.

#docs, #meeting, #summary

Milana Cap 10:50 am on April 13, 2026
Tags: ,   

X-post: Documentation Team Update – April 13, 2026

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

Andrea Roenning 7:53 pm on April 7, 2026
Tags: , ,   

Documentation team meeting notes – April 7, 2026

Where: #docs channel on 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/
When: Tuesday, April 7, 2026, 14:00 UTC
Meeting Facilitator: @estelaris
Note Taker: @awetz583
Find the complete meeting on Slack.

Next Meetings

Planning Meeting

Where: #docs channel on Slack + Video call
When: Tuesday, April 14, 2026, 14:00 UTC

Discussion Meeting

Where: #docs channel on Slack
When: Tuesday, April 21, 2026, 14:00 UTC

View upcoming dates on the Documentation Team meeting calendar.

Updates

Blocks articles overhaul

  • @estelaris compiled open issues related to blocks and features into a spreadsheet for the Blocks Overhaul Project. She finished labeling, reviewing the 26 pages of issues 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 by the repository owner. https://github.com/ and closed issues that were resolved or repeated.
  • @awetz583 is working on updates to the Buttons Block page.
  • @supernovia made changes to the Docs Handbook.

Issue label discussion

The team discussed removing the automatic “to-do” label on new issues in Github, as it did not provide value. The label process is currently outlined on the Documentation issue tracker page.

Advanced Admin & DevHub issue tracking planning

@estelaris discussed the need for someone to focus on the DevHub and Advanced Admin areas.

  • If a new page is requested and it now exists > close ticket
  • If a broken/missing link is reported > update link and close ticket
  • If a code review is requested > check if a solution has been provided. If not, add solution to ticket, test if you can and create PR for Advanced Admin. For Code Review, we may have to report to coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress.

The Docs team goal is to close as many issues as possible before WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. Europe on June 4th.

#docs, #meeting, #summary