Milana Cap 8:00 am on June 13, 2022  

Onboarding to Documentation team

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.

Karthick 1:09 pm on March 6, 2025
Tags: , ,   

Summary for Discussion Meeting (04-Mar-2025)

Attendance

@sumitsingh @Karthick @Troy @estelaris @milana_cap

Housekeeping

Find the complete Transcript of the meeting on Slack.

Upcoming Meetings

Project Checks

@karthickmurugan has completed several HelpHub issues related to WordPress 6.7, and they are now ready for review before further progress. Most of these issues are documented in the following triage issue: #1841.

#docs, #meetings, #summary

Courtney Robertson 1:24 pm on March 4, 2025
Tags: ,   

X-post: Help Test WordPress 6.8

X-comment from +make.wordpress.org/test: Comment on Help Test WordPress 6.8

Sagar Gurnani 1:16 pm on February 18, 2025
Tags: , ,   

Agenda for Discussion Meeting (18-Feb-2025)

ting is scheduled with the following details:

When: Tuesday, 18-Feb-2025 14:00 UTC

Where: #docs channel on Slack

Agenda:

  1. Attendance.
  2. Note-taker and facilitator selection for the next docs team meeting.
  3. Facilitator selection for the next triage.
  4. Project check.
  5. Design updates by @estelaris.
  6. Open floor.

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

#agenda, #docs, #summary

Sagar Gurnani 1:07 pm on February 18, 2025
Tags: , ,   

Summary for Discussion Meeting (04-Feb-2025)

Attendance

@atachibana @ninianepress @sagargurnani @leonnugraha @cwhitmore @dhavalkapadane @joelbarbara @benazeer @zeelthakkar @estelaris @milana_cap (async)

Housekeeping

Find the complete Transcript of the meeting on Slack.

Upcoming Meetings

Project Checks

@atachibana has been working on the issues related to WP6.3 and likes to close them ASAP.

@karthickmurugan has completed 26 tickets, in which 3 of the issues moved to 2nd review and others pending for review.

@joelbarbara had discussed with @estelaris working on tickets related to release 6.2. So, he had worked on his first issue and wanted someone to review it.

@benazeer had worked on WP6.7 issue related to “post excerptExcerpt An excerpt is the description of the blog post or page that will by default show on the blog archive page, in search results (SERPs), and on social media. With an SEO plugin, the excerpt may also be in that plugin’s metabox.”, “site tagline” and “verse blocks” and now she is waiting for the review.

@dhavalkapadane he had added screenshots, videos, and steps to #1767 and wanted someone to review it.

Open Floor

@estelaris mentions that because 6.8 is a release with no new features. The docs team should focus on catching up with previous releases and work on anything that’s outstanding.

@ninianepress thinks the idea of trying some A/B testing and changing the name of the Triage meetings is a great initiative. She also thinks that trying something without data isn’t as helpful as it would be to ask people why they don’t attend and/or contribute to those meetings. May be the team could make a quick Google form with different options and a space to add our answers. That way, we have some more insight to make informed plans for further testing.

@ninianepress is also planning on facilitating a Contributor Day this month so she’ll keep everyone posted on that.

#docs, #meetings, #summary

Estela Rueda 5:35 pm on February 7, 2025
Tags:   

Summary Meeting 28 January 2025

Instead of regular meeting, the team held office hour and guided new contributors through the process.

The 6.8 release team announced that this release will focus primarily on being a polish and bug fix release and new features will be added if they are necessary. For this reason, the #docs team will be focusing on catching up with outstanding issues from previous releases.

These are the outstanding items from previous releases:

These issues are open to any contributor that wants to work on them. Let the team know 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 to let the team review and update the issues.

New contributors can review the Onboarding to Documentation team videos to understand the process.

Oladapo Babarinde 10:46 am on November 10, 2024
Tags: , ,   

Summary for Docs Team Meeting (5-Nov-2024)

Attendance

@leonnugraha @dapobabarinde @wowashuwow @faguni22 @ivahyael @sagargurnani (async) @joellobo1234

Housekeeping

Find the complete Transcript of the meeting on Slack.

Upcoming Meeting

Where: #docs channel on Slack

When: Tuesday, November 19, 2024, at 14:00 UTC

Meeting facilitator: @leonnugraha

Note taker: @dapobabarinde

Upcoming Planning Session: Doc team Planning session Tuesday, 12 November 2024, 2 PM UTC

Facilitator: @leonnugraha

Project Check

@wowashuwow self-assigned #1776 as the first issue he will be working on.

@dapobabarinde also worked on #1513, which is still under review.

Open Floor

@leonnugraha – WordPress 6.7 will be released next week, and we already have some 6.7 update issues in the repository. Feel free to look at them and assign yourself.

@leonnugraha will host an onboarding session next Tuesday at 1 p.m. UTC (one hour before the meeting). 

He also said he’ll add the video call link on the Doc Team 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/. channel later this week.

Those who are interested should leverage this opportunity.

Estelaris’ Update

No update from Estelari this week.


#docs, #meetings, #summary

Kaito Hanamori 11:26 pm on November 4, 2024
Tags: ,   

X-post: Training Team Updates – November 2024

X-comment from +make.wordpress.org/updates: Comment on Training Team Updates – November 2024

Oladapo Babarinde 8:58 pm on October 19, 2024
Tags: , ,   

Summary for Docs Team Meeting (15-Oct-2024)

Attendance

@dapobabarinde @milana_cap @psalmadek @faguni22 @atachibana @writinglearning @estelaris @sagargurnani @costdev

Housekeeping

Find the complete Transcript of the meeting on Slack.

Upcoming Meeting

The docs team will be having an Online Monthly Docs Team 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

When: Tuesday, 22 October 2024, 1:00-3:00 PM UTC

Meeting facilitator: @jenni

Open Floor

@writinglearning and @psalmadek recently joined the #docs team and were attended to by @atachibana, who gave them some onboarding tips.

Estelaris’ Update

@estelaris created an issue on 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 Yoast’s Contributor Day, Which was held on Thursday from 7:30 to 14:00 UTC

#docs, #meetings, #summary

#meetings, #summary

Jenni McKinnon 4:39 am on October 17, 2024
Tags: ,   

Online monthly Docs Team Contributor Day October 22, 2024

The Documentation Team holds an online, monthly Contributor Day on the fourth Tuesday of every month. Any one may join who wishes to contribute to the team and who follows the Code of Conduct.

The next Docs Team 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 next monthly online Docs Team Contributor Day will be:

When: Tuesday, 22 October, 2024, 1:00-3:00 PM UTC

Where: #docs channel on Slack, and on Zoom.

Onboarding on Zoom

In addition to the details 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 be the repository owner. https://github.com/ issue for this Contributor Day, folks who need onboarding can ask 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/. or on the Zoom call. In Zoom, a breakout room will be started where contributors can be onboarded.

If at any time you have any questions, please feel free to ask in the #docs channel on Slack or in Zoom throughout the day.

After Contributor Day

Other than celebrating with some 🍪🍪🍪 after Contributor Day is over, please also comment on the corresponding GitHub issue with:

  1. Your WordPress.org profile username
  2. What you worked on and include links when possible.

Or, just comment anything (such as your WordPress.org username) to let the team know you attended.

#contributor-day, #docs

Ahmed Kabir Chaion 6:35 am on October 11, 2024
Tags: ,   

X-post: Help Test WordPress 6.7

X-comment from +make.wordpress.org/test: Comment on Help Test WordPress 6.7