Make WordPress Documentation – Making WordPress Docs

Make WordPress Documentation – Making WordPress Docs
Skip to content
Make WordPress Documentation
Welcome to the official home of the WordPress Documentation Team.
This team is responsible for coordinating all documentation initiatives around WordPress, including the handbooks and other general wordsmithing across the WordPress project.
Want to get involved?
Start here to find out more about what we do and how to contribute:
Onboarding to Documentation Team
: An overview of what we do and how to collaborate
Documentation Issue Tracker on GitHub
: Submit any Documentation Team-related issues on
GitHub
GitHub
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.
Weekly meetings
Join our discussions of documentation issues here on the blog and on
Slack
The documentation team holds
weekly office hours and monthly Contributor Days
on each Tuesday of the month in the
#docs
Slack
Slack
Slack is a Collaborative Group Chat Platform
. The WordPress community has its own Slack Channel at
channel. It’s also where you can contact the team at any time outside meetings.
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:
WordPress.org account
WordPress Slack account
wordpress.org
WordPress.org
The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization.
account is needed).
GitHub account
– connect
your GitHub account to your WordPress.org profile
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
GitHub
GitHub
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.
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:
A more recent onboarding session, recorded on 28th July 2023, can be found here:
End user documentation
internally called
HelpHub
Located at
Recording:
Developer documentation
Internally called
DevHub
Located at
Developer documentation –
Plugin
Plugin
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
or can be cost-based plugin from a third-party.
handbook
Located at
Recording:
Developer documentation – Common APIs handbook
Located at
Recording:
Developer documentation – Code reference handbook
Located at
Recording:
Developer documentation –
Block
Block
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
Located at
Recording:
Developer documentation – Themes handbook
Located at
Recording:
Contributor documentation – Documentation team handbook
Located at
Recording:
Github related roles
Located at:
Recording:
If you have any questions or you’d like to have an “in more detail” session, feel free to leave the comment below.
Where:
#docs
channel on
Slack
Slack
Slack is a Collaborative Group Chat Platform
. The WordPress community has its own Slack Channel at
When:
Tuesday, April 21, 2026, 14:00 UTC
Meeting Facilitator:
estelaris
Note Taker:
awetz583
Next Meetings
Contributor Day
Contributor 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
There are many teams that people can participate in, each with a different focus.
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
The documentation team needs help, especially from
core
Core
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
GitHub
GitHub
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.
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:
Themes
: 146 open issues.
DevHub:
101 open issues (these may overlap with themes and advanced admin)
Advanced Admin
: 33 open issues.
Migration from Codex
: 12 open issues.
Plugins
: 10 open issues.
HelpHub:
358 open issues.
Handbook
: 18 open issues (some overlap with internal tasks)
Internal tasks
: 30 open issues.
Questions?
Ping
Ping
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
Slack
Slack
Slack is a Collaborative Group Chat Platform
. The WordPress community has its own Slack Channel at
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
Where:
#docs
channel on
Slack
Slack
Slack is a Collaborative Group Chat Platform
. The WordPress community has its own Slack Channel at
+ 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 Day
Contributor 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
There are many teams that people can participate in, each with a different focus.
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
block
Block
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
Github
GitHub
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.
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
WordCamp
WordCamp
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.
Asia will receive
WordPress.org
documentation profile badges.
docs
meeting
summary
X-comment from
+make.wordpress.org/updates
: Comment on
Documentation Team Update – April 13, 2026
Where:
#docs
channel on
Slack
Slack
Slack is a Collaborative Group Chat Platform
. The WordPress community has its own Slack Channel at
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
Github
GitHub
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.
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
core
Core
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
WordCamp
WordCamp
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.
Europe on June 4th.
docs
meeting
summary
Hello WordPress Documentation Team contributors!
We’re excited to see you, collaborate, and reconnect in person at
WordCamp Asia 2026
in Mumbai, India
. Events like this offer a unique opportunity for contributors across the Asia-Pacific region and beyond to gather, exchange experiences, and support each other in strengthening the WordPress project — both locally and on a global scale.
This year,
WordCamp
WordCamp
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.
Asia 2026 takes place in Mumbai, India, and will feature
Contributor Day
Contributor 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
There are many teams that people can participate in, each with a different focus.
, conference sessions, networking, and community-building activities. If you’re planning to attend, we’d love to see you at the Documentation Team table during
Contributor Day
WordCamp Asia 2026 Details
Here are the key details for WordCamp Asia 2026:
Location
: Mumbai, India
Venue
Jio World Centre
G Block, Bandra Kurla Complex, Bandra East, Mumbai, Maharashtra 400098
Dates
: April 9, 2026
Programs
Documentation Team at Contributor Day
Contributor Day is one of the most welcoming and energizing parts of any WordCamp. It’s a dedicated day for attendees to contribute to the WordPress open-source project by joining one of the many Make WordPress teams.
For the Documentation Team, Contributor Day is a chance to:
Welcome new contributors,
Reconnect with existing contributors,
Review and write WordPress documentation for end users and developers,
Review and write documentation for WordPress release 7.0
First time at Contributor Day? No prior experience is needed to get involved. The Documentation Team table is the perfect place to discover how the team operates, explore the different ways you can contribute, and find out how your skills and interests can make a meaningful impact within documentation.
Detailed Contributor Day Schedule
Location
: Documentation Team Table, Lotus Hall, Jio World Convention Centre, Mumbai
Date
: April 9, 2026
08:00 am IST Registration Open and Networking Time
09:00 am IST – Opening Remarks
09:30 am IST – Family Photo
09:45 am IST – Contributing to WordPress/Workshop/Open-Source Library
10:00 am IST – The Making of a WordPress Release: Conversations with Past Release Squad Members
12:00 pm IST Long Break and Networking Time
01:45 pm IST – Table Leads Photo
02:00 pm IST – Contributing to WordPress/Workshop/Open-Source Library
04:30 pm IST – Closing Remarks
05:00 pm IST Contributor Day Wrap-up
What to Expect at The Documentation Team Table
At the Documentation Team table, participants may work on:
Onboarding new contributors,
Reviewing and updating documentation for
core
Core
Core is the set of software required to run WordPress. The Core Development Team builds WordPress.
blocks,
Reviewing and/or writing user documentation for WP 7.0 release
Table Leads
This year’s Contributor Day at WordCamp Asia, the Documentation Team will be led by
clk87
with both
bph
and
rollybueno
will help with the onboarding of new contributors.
If you have experience contributing to the Documentation Team, we would love to invite you to take part in the new initiative introduced by Contributor Day Team –
Contributor Buddy
Contributor Buddy
is a new initiative that makes Contributor Day feel more approachable, especially for newcomers. Experienced contributors volunteer at team tables to help others understand how the team works, find beginner-friendly tasks, and get started with confidence.
If you are planning to join the Documentation Team and have previous contribution experience, simply reach out to
clk87
or
rollybueno
and express your interest in becoming a Contributor Buddy. If appropriate, they will provide you with a Contributor Buddy badge.
Things to prepare before WC Asia
If this is your first time contributing to the Documentation team, please make sure you have the following accounts:
WordPress.org account
WordPress Slack account
wordpress.org
WordPress.org
The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization.
account is needed).
GitHub account
– connect
your GitHub account to your WordPress.org profile
Make sure you join
#docs
Slack
Slack
Slack is a Collaborative Group Chat Platform
. The WordPress community has its own Slack Channel at
channel. Once there, just wave 🙂
The following videos/onboarding sessions can be helpful for performing the tasks we plan to work on:
General overview
End user documentation
Updating screenshots
All Documentation team onboarding sessions
For general details on how
GitHub
GitHub
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.
works, check out
GitHub’s Getting Started Guide
When you find issue you’d like to work on in the
Docs Team Issue Tracker
here on GitHub:
Please leave a comment in that issue so that we can assign you and to avoid more people working on the same issue, and
In that comment, also be sure to tag the
team rep responsible for the handbook
that your chosen task is about.
For example, if your task is for the
Block
Block
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 End-User documentation, you would tag
@atachibana
Check out the
Team page in the Documentation Team Handbook
for a list of team reps.
Join Us in Mumbai
Whether you are an experienced contributor or completely new to the WordPress project, we’d love to see you at the Community Team table during Contributor Day.
Come learn, contribute, connect, and help shape the future of WordPress communities.
Joining us in Mumbai? Stop by the Documentation Team table and be part of the conversation. Let’s build community together!
Props
estelaris
for preparing the callout
post
X-comment from
+make.wordpress.org/updates
: Comment on
Documentation Team Update – April 6, 2026
Where:
#docs
channel on
Slack
Slack
Slack is a Collaborative Group Chat Platform
. The WordPress community has its own Slack Channel at
When:
Tuesday, March 17, 2026, 14:00 UTC
Meeting Facilitator:
milana_cap
Note Taker:
awetz583
Find the complete meeting
on Slack.
Next Meetings
Contributor Day
Contributor 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
There are many teams that people can participate in, each with a different focus.
Where
#docs
channel on Slack + Video call
When
Tuesday, March 24 2026, 14:00 UTC
Discussion Meeting
Where:
#docs
channel on Slack
When:
Tuesday, March 31 2026, 14:00 UTC
View upcoming dates on the Documentation Team meeting calendar.
Updates
Preparing for 7.0 Documentation
milana_cap
shared videos for preparing tools and workflows, and outlined the plan to update docs this week following a guideline and a list of items in “Good Progress/Ready” status.
Create GH project
GitHub automation
GH project access
sajib1223
confirmed he has watched the videos and will join the meeting to start working on the green list items.
Blocks articles overhaul
awetz583
is working on updates to Media & Text
block
Block
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.
documentation and has others ready for review on the
Blocks articles overhaul board
Good first issues
supernovia
asked about the status of Good First Issues, and
milana_cap
mentioned that some can be closed while others need updating. They plan to review these during the upcoming Contributor Day.
Open Floor
Pathways and Handbook Updates
supernovia
and
milana_cap
discussed
moving the pathways work to GitHub
, with the goal of keeping handbook pages as the detailed reference and the guides as checklists. They agreed this would make it easier for the community to contribute and review the content.
Handbook feedback
estelaris
raised an issue about a WP Credits student’s feedback on the handbook content, noting that some paragraphs read differently in Spanish compared to the English version. They requested help to compare the handbook content with the student’s suggestions and identify any areas that need improvement in the writing style.
Contributor Day Planning
milana_cap
mentioned that she will be available for 2 hours during the upcoming Contributor Day at
Tuesday, March 31 2026, 14:00 UTC
, and there will be no formal meeting notes or facilitators, just focused contribution time.
docs
meeting
summary
X-comment from
+make.wordpress.org/updates
: Comment on
Documentation Team Update – March 16, 2026
Where:
#docs
channel on
Slack
Slack
Slack is a Collaborative Group Chat Platform
. The WordPress community has its own Slack Channel at
+ Video call
When:
Tuesday, March 10, 2026, 14:00 UTC
Meeting Facilitator:
estelaris
Note Taker:
awetz583
Next Meetings
Discussion Meeting
Where:
#docs
channel on Slack
When:
Tuesday, March 17 2026, 14:00 UTC
Contributor Day
Contributor 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
There are many teams that people can participate in, each with a different focus.
Where
#docs
channel on Slack + Video call
When
Tuesday, March 24 2026, 14:00 UTC
View upcoming dates on the Documentation Team meeting calendar.
Open Floor
parinpanjari
discussed updating an image for
Get Started with WordPress
documentation
estelaris
and
awetz583
discussed documentation ready for review in the
Blocks articles overhaul project board
docs
meeting
summary
Site resources
Submit your contributions
Have you contributed to the Documentation team but didn't receive recognition? Submit this form each time you contribute, and we'll make sure you receive it. Thank you for contributing
← Back
Your contribution has been submitted
Weekly Meetings
First Tuesday
: Discussion meeting –
14:00 UTC
Slack chat
Second Tuesday
: Monthly planning meeting –
14:00 UTC
Video call
Third Tuesday
: Discussion meeting –
14:00 UTC
Slack chat
Fourth Tuesday
: Online Contributor Day –
14:00 UTC
to
16:00 UTC
Video call
Fifth Tuesday
: Discussion meeting –
14:00 UTC
Video call
Latest Projects
WordPress 6.9 Documentation
WordPress 6.8 Documentation
WordPress 6.7 Documentation
Join the team
Workflows
Team roles
GitHub repo:
Documentation-Issue-Tracker
Email Updates
Enter your email address to subscribe to this blog and receive notifications of new posts by email.
Join 1,822 other subscribers
Recent Updates
Recent Comments
No Replies
Team Pledges
1287 people
have pledged time to contribute to Documentation Team efforts! When looking for help on a project or program, try starting by reaching out to them!
compose new post
reply
edit
go to top
go to the next post or comment
go to the previous post or comment
toggle comment visibility
esc
cancel edit post or comment