Tag Archives: docs

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

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

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

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: docs   

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: docs, ,   

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

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

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

Andrea Roenning 5:53 pm on March 17, 2026
Tags: docs, ,   

Documentation team meeting notes – March 17, 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, March 17, 2026, 14:00 UTC
Meeting Facilitator: @milana_cap
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, 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.

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

Andrea Roenning 2:58 pm on March 10, 2026
Tags: docs, ,   

Documentation team meeting notes – March 10, 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, 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 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, March 24 2026, 14:00 UTC

View upcoming dates on the Documentation Team meeting calendar.

Open Floor

#docs, #meeting, #summary

Andrea Roenning 6:29 pm on March 3, 2026
Tags: docs, ,   

Documentation team meeting notes – March 3, 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, March 3, 2026, 14:00 UTC
Meeting Facilitator: @milana_cap
Note Taker: @awetz583
Find the complete meeting on Slack.

Next Meetings

Discussion Meeting

Where: #docs channel on Slack + Video call
When: Tuesday, March 10 2026, 14:00 UTC
Facilitator: @estelaris

Discussion Meeting

Where: #docs channel on Slack
When: Tuesday, March 17 2026, 14:00 UTC

View upcoming dates on the Documentation Team meeting calendar.

Facilitation Resources

Helpful resources for facilitating the meeting and writing the meeting notes.

Project Checks: Contributions

  • @awetz583 Worked on Video block, Verse block, Image block, and File block which are ready for review.
  • @milana_cap
    • Completed and closed Pullquote block and List block.
    • Recorded 3 short videos for documenting the 7.0 release and uploaded them to wordpress.tv (these will be available soon.)
    • Created a Github project for 7.0 Documentation, added automation with 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/ workflow to add issues with 7.0 label automatically and added access to release team to the project.
  • @rollybueno Completing working on 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. overhaul including Quote block and Code block.
  • @supernovia Contribution Pathways is now on Github and will continue to receive updates.
  • @parinpanjari Working on updates for Get started with WP article.

The team is now down to 657 open issues, with 28 issues closed in the past week.

Documenting WordPress 7.0 release

@estelaris proposed changes to the WordPress release day workflows, including reversing the order of the WordPress Versions page to show the latest version first, removing the Roadmap page from the team’s responsibilities, and updating the History and “Learn about WordPress origins and version history” pages. The team discussed the challenges and potential solutions, including exploring automation and using Contributor Days for manual updates.

Open Floor

Reviewing the Documentation Review Process

@supernovia asked the team to review the documentation review process and @estelaris and @milana_cap plan to provide feedback.

Switching to Video Meetings

@milana_cap proposed switching some of the team’s meetings to video calls, as video discussions tend to be more productive than Slack-only meetings. The team decided to add additional video calls to the monthly schedule.

New schema for docs meetings:

#docs, #meeting, #summary

Milana Cap 6:37 pm on February 25, 2026
Tags: docs, ,   

Documentation team meeting notes – February 24, 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, February 24 2026, 14:00 UTC
Meeting Facilitator: @supernovia
Note Taker: @milana_cap
Find the complete meeting on Slack.

Next Meetings

Discussion Meeting

Where: #docs channel on Slack
When: Tuesday, March 3 2026, 14:00 UTC
Facilitator: @supernovia
Note Taker: @azharderaiya

Discussion Meeting

Where: #docs channel on Slack
When: Tuesday, March 10 2026, 14:00 UTC
Facilitator: @estelaris

Facilitation Resources

Helpful resources for facilitating the meeting and writing the meeting notes.

Project Checks: Contributions

The team is now down to 683 open issues, with 5 issues closed in the past week.

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

The Documentation team is missing the table lead for the WordCamp Asia Contributor Day. The team has been discussing possible leads from the list of registered attendees: @sagargurnani, @anandau14, as possible table leads, with help from @bph and @clk87.

Documenting WordPress 7.0 release

With the smaller release squad, the Docs team has two representatives volunteered to work on updating end-user docs for 7.0, @sajib1223 and @milana_cap. The team will follow instructions drafted by @estelaris, while working on this new workflow together with @annezazu on 6.9 release. In this scenario, @milana_cap will act as a mentor due to her experience with working on release docs in previous releases. As the others expressed the interest, this will be done publicly (in the #docs channel), starting from next week.

A very helpful resource is provided by @annezazu in the comment on the planning post for 7.0.

Open Floor

Contribution Pathways

@supernovia noted that, by WordCamp Asia, we should have several contribution pathways ready. These will be moved to 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 available to new contributors at Contributor Day. @estelaris shared the general GitHub issue the team uses for Contributor Days.

Previously, @supernovia shared three “contribution pathway” one-pagers created by @clk87:

Goals for these guides:

  • Provide clear, step-by-step entry points for new and existing contributors.
  • Eventually be linked from the main contribution index (final location still to be decided).
  • Support a growing pool of 200+ student contributors looking for ways to contribute, with more students coming.

AI-powered documentation assistant for WordPress coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. blocks

@estelaris shared the draft about the AI-powered documentation assistant for WordPress core blocks (draft) that she will be working on with the #core-ai team, and hopefully will be ready for 7.1 It will be trained to give recommendations based on existing 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. docs. This is one of the reasons why Overhaul has been pushed for the block docs to be updated.

Any comments, ideas, questions, and reviews for the draft are welcome. Please, leave them in the document.

#docs, #meeting, #summary

Velda 5:40 am on February 24, 2026
Tags: , docs,   

Agenda for Discussion Meeting on February 24, 2026

The meeting is scheduled with the following details:

When: Tuesday, February 24, 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. Prepping for 7.0
  5. Open floor.

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

#agenda, #docs, #meetings