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.

Agenda for Docs Team Biweekly Meeting (February 20, 2024)

The next meeting is scheduled with the following details:

WhenTuesday, 20 February 2024, 02:00 PM UTC

Where#docs channel on Slack

Agenda:

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

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

#agenda, #meetings

X-post: Project Thread: Documentation Redesign

X-post from +make.wordpress.org/meta: Project Thread: Documentation Redesign

Summary for Docs Team Meeting (11-Feb-2024)

Attendance

@estelaris @milana_cap @leonnugraha @sagargurnani @ninianepress @atachibana @anandau14 @noumantech @cold-iron-chef @stevenlinx @kafleg @hellosatya (async) @iamasadpolash (async)

Housekeeping

Find the complete Transcript of the meeting on Slack.

Upcoming Meeting

Project Checks

@milana_cap had updated the WordPress Versions Page.

@sagargurnani had worked on the following issues:

  1. Needs Review – #430.
  2. In progress – #954 and #958.
  3. Ready to be published – #935.
  4. Closed – #430.

@leonnugraha had completed and closed #1241 and #1347.

@atachibana is working on #291.

@ninianepress had submitted an amplification request to the #marketing team for February 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/. #363.

@anandau14 had updated #1332 by adding screenshots and is waiting for it to get reviewed.

Open Floor

@estelaris discussed the following 4 points:

  1. Proposal: An update to the Field Guide: During last dev chat the future of the proposal was discussed in which the team had suggested that other teams should also get involved. The #docs team now needs to decide whether to accept the proposal or to suggest changes.
  2. Feedback on the Wishlist for the redesign of /documentation/ were provided. The #docs team must give suggestions now.
  3. Figma file: At the bottom of the landing page, there is a field that only links to “Support Forums” and “Developers”. The docs team needs to provide ideas on how to utilize that space better.
  4. She also asked us to provide our thoughts on 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. for Docs (24 hours online), to include talks and working sessions. This is the document with her Initial Suggestions. Almost, everyone in the team liked the idea.

@sagargurnani asked whether the contributors can close the issues by themselves, to which @estelaris and @leonnugraha answered that the issue assignees can close the issues by themselves but only when it is reviewed and approved by the issue reviewer, otherwise they should request the issue owner or the #docs team repTeam Rep A Team Rep is a person who represents the Make WordPress team to the rest of the project, make sure issues are raised and addressed as needed, and coordinates cross-team efforts. to close the issue.

#docs, #meetings, #summary

X-post: Improving block development documentation: 2023 recap and a look ahead

X-post from +make.wordpress.org/core: Improving block development documentation: 2023 recap and a look ahead

Agenda for Docs Team meeting February 6, 2024

The next meeting is scheduled with the following details:

WhenTuesday, 6 February 2024, 02:00 PM UTC

Where#docs channel on Slack

Agenda:

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

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

#agenda, #meetings

Summary of Docs Team meeting January 23, 2024

Attendance

@ninianepress @milana_cap @leonnugraha @atachibana @anandau14 @sagargurnani @psykro @hellosatya @devmuhib @estelaris

Housekeeping

Find the complete Transcript of the meeting on Slack.

Upcoming meetings

Here’s a shortlist of the upcoming Docs Team meetings with facilitators and note takers detailed below:

Next team meeting

Next triage meeting

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

Project checks

@milana_cap cleaned up HelpHub feedback and made new issues from valid ones:

  • List of newly created issues 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/
  • List of new issues created for the Advanced Administration Handbook

@milana_cap also re-uploaded missing images and completed updates for 6.1 and for #278.

@sagargurnani finished:

@anandau14 reviewed and suggested edits for #716.

@leonnugraha reviewed and closed #1203 as well as reviewed and suggested for #491.

Open floor

@leonnugraha and @estelaris were announced as the 6.5 Release Squad with @sagargurnani learning and assisting. Congratulations from the Docs Team! 🎉🍪

@anandau14 shared their experience of WCNepal Contributors Day on 12 Jan. 2024 as the Docs Team Table Lead: Over 50+ attendees joined and it was an amazing experience.

@ninianepress opened an issue in GitHub to create an onboarding message when someone joins the 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/.. Please contribute ideas and copy through #1440.

Also, the call for mentors and mentees is open for the Q1 WordPress Mentorship Program. You still have time to sign up to onboard new contributors or sign up to be a mentee and be onboarded. If you’re interested at all, please take a look at the post about it: Call for Mentees & Mentors: Contributor Mentorship Program Cohort #2 (2024 Q1).

@psykro started running WordPress developer livestreams focused on contributing to WordPress and wanted to run a live stream, taking part in a Docs Team Online Contributor Day, and wanted to check if it was okay. The Docs Team welcomed the idea.

@estelaris mentioned issues that needed to be discussed:

  • “Importing content information” should it be under Advanced Admin handbook or under support docs? Issue #1439
    • Please see the corresponding GitHub issues for updates and to contribute.
  • We need to have a wish list of items that we would like for the redesign of /documentation/ site; we want to build something like this.
    • Items were discussed and added to the wish list document for further discussion. Please add your comments there.

#docs, #meetings, #summary

X-post: Incident Response Team: Call for Nominations

X-comment from +make.wordpress.org/project: Comment on Incident Response Team: Call for Nominations

Online monthly Docs Team Contributor Day February 27, 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, 27 February 2024, 1:00-4:00 PM UTC

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

Please also see Contributor Day — 27 February, 2024 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 onboarding and other important details.

Onboarding on Zoom

In addition to the details in the GitHub issue for this Contributor Day, folks who are in need of 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.orgWordPress.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. https://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

Online monthly Docs Team Contributor Day January 30, 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, 30 January 2024, 1:00-4:00 PM UTC

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

Please also see Contributor Day — 30 January, 2024 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 onboarding and other important details.

Onboarding on Zoom

In addition to the details in the GitHub issue for this Contributor Day, folks who are in need of 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.orgWordPress.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. https://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

Agenda for Docs Team meeting January 23, 2024

The next meeting is scheduled with the following details:

WhenTuesday, 23 January 2024, 02:00 PM UTC

Where#docs channel on Slack

Agenda:

  1. Attendance
  2. Note-taker and facilitator selection for next meeting
  3. Facilitator selection for next triage meeting
  4. Project check
  5. Open floor

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

#agenda, #meetings