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/

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

If you have any questions or you’d like to have an “in more detail” session, feel free to leave the comment below.

Erica Varlese 4:44 pm on February 21, 2023
Tags: ,   

X-post: HelpHub and DevDocs redesign request

X-post from +make.wordpress.org/polyglots: HelpHub and DevDocs redesign request

Jenni McKinnon 11:03 pm on February 10, 2023
Tags: ,   

Agenda for Docs Team bi-weekly meeting February 21, 2023

The next meeting is scheduled with the following details:

When: Tuesday, 21 February 2023, 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. Projects checks
  5. Discussion on a proposed application for the Google Season of Docs
  6. Open floor

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

#agenda, #meetings

Jenni McKinnon 10:30 pm on February 10, 2023
Tags: , ,   

Summary for Docs Team meeting, February 7, 2023

Attendance

@ninianepress @milana_cap @leonnugraha @femkreations @estelaris @ninthcoder @JavierCasares @magaliechetrit

Housekeeping

Find the complete Transcript of the meeting on Slack.

Project checks

@milana_cap finished the WordCamp Asia Contributor Day Plan.

@femkreations completed reviewing the closed pull requests (PRs) 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 be the repository owner. https://github.com/ for Gutenberg from 14.2 through 15.0, and the User Documentation label was added. Femy also reviewed and closed one WordPress 6.1 issue.

@estelaris posted #652 and #651, but it was later moved 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. TracTrac Trac is the place where contributors create issues for bugs or feature requests much like GitHub.https://core.trac.wordpress.org/. Ticket #6740.

@leonnugraha reviewed and published #502 and #176.

Discussion on what can be done for the WCAS 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/.

@milana_cap is working on an interactive plan to onboard new contributors.

@milana_cap also organized onboarding sessions for the new non-project roles: Issue Triage Facilitator, Issues Coordinator, and Issues Reviewer. The session will be recorded, and posted on WordPress.tv.

Open floor

@JavierCasares mentioned two meta trac tickets – #6411 and #6714. Both need follow-ups and @milana_cap will leave a comment on the ticket for updates or ask about them in an upcoming meta meeting.

Props to @leonnugraha for writing this meeting summary.

#docs, #meetings, #summary

Julia Golomb 1:02 am on February 8, 2023
Tags: ,   

X-post: Apply to Attend the 2023 Community Summit

X-comment from +make.wordpress.org/community: Comment on Apply to Attend the 2023 Community Summit

estelaris 5:58 pm on February 7, 2023
Tags:   

Future plans for HelpHub

At the end of January, the docs and 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. teams launched the new site for documentation, internally known as HelpHub. The team’s work is not done as we are still updating old articles and continue writing new ones. The goal is to release new feature articles as close to the latest WordPress version release as possible.

Still missing and tracking

  1. Update legacy colors #26
  2. The change log is still a work in progress #6
  3. Finish the documentation inventory https://github.com/orgs/WordPress/projects/23
  4. Review the handbook pages for HH and update all
  5. Review and close HH meta tickets
  6. Review and close tickets on HH developing repository

Next steps

Promote the work, tell the world! Announce it everywhere. It has been 8 years since the HelpHub project kicked-off. Most of the initial members are not around as contributors any longer.

The documentation team will continue working in bringing the updated documentation and promote collaboration with other teams, like:

  1. Discuss with polyglots teamPolyglots Team Polyglots Team is a group of multilingual translators who work on translating plugins, themes, documentation, and front-facing marketing copy. https://make.wordpress.org/polyglots/teams/. how can we help in implementing the new site map and reorganizing articles that are already translated. This effort will be different with each local team as it will depend on the local teams processes and availability.
  2. Update content with polyglots – can we create GH issue track per rosetta site? What would be the best process for each locale.
  3. Introducing the new documentation and developer sites in WordCamps, during 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/. so we can encourage other teams to implement the changes in their own languages.
  4. Work with the training team to create a crosslink Resources 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. where we can link Learn videos/courses/tutorials and vice versa.

Props to @milana_cap for reviewing the content of this article.

#helphub

Jenni McKinnon 9:34 am on February 7, 2023
Tags: ,   

Agenda for Docs Team bi-weekly meeting February 7, 2023

The next meeting is scheduled with the following details:

When: Tuesday, 7 February 2023, 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. Projects checks
  5. Discussion on what can be done for the WCAS Contributor Day
  6. Open floor

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

#agenda, #meetings

Sam Suresh 3:01 pm on February 6, 2023
Tags: ,   

X-post: Community Booth at WordCamp Asia 2023

X-post from +make.wordpress.org/community: Community Booth at WordCamp Asia 2023

Milana Cap 12:48 pm on February 3, 2023  

Onboarding session for GitHub-related roles

The Documentation team recently revised team roles and areas of responsibility, which are documented in our handbook. While doing so, we identified a number of areas that are not project related but require enough work to be considered separate roles. Three of those roles (Issue triage facilitator, Issues coordinator, and Issues reviewer) are tight to GitHub issues and projects, and for those roles, we are going to run an onboarding session next week.

Session info:

Please note that there is no limit to how many people can perform the same role. If you are interested in getting involved, or not sure if you are interested yet, do try to join us and ask anything you want. If you can’t make it, the recording will be published together with all the other onboarding sessions.

Anything else you want to add or ask, you can do so in the comments below.

Jenni McKinnon 3:28 pm on January 31, 2023
Tags: , ,   

Summary for docs team meeting, January 24, 2023

Attendance

@leonnugraha @ninianepress @milana_cap @estelaris @ninthcoder @atachibana @femkreations

Housekeeping

Find the complete Transcript of the meeting on Slack.

Project checks

@milana_cap is working on crafting the WCAS Contributor Day task list.

@ninianepress finished issue #128.

Status update for HelpHub

@estelaris walked through the recently finished updates to the End-User Documentation (HelpHub, internally).

For full details of these changes, please see New look, new site, new HelpHub.

Status update for DevHub

@estelaris noted that @javiercasares (not in attendance) is the project lead for the Developer Handbook (DevHub, internally) redesign. She mentioned that the design has been finalized, and development work has begun.

Open floor

@milana_cap mentioned there is a new non-project role in the team that no one has been doing before: GitHub issues coordinator.

@femkreations would also like to note that issue gardening for v6.2 is in progress from the 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/ pull requests (PRs).

#docs, #meetings, #summary

Ben Greeley 3:16 pm on January 26, 2023
Tags: ,   

X-post: WordPress.org Redesign Recent Launches

X-comment from +make.wordpress.org/meta: Comment on WordPress.org Redesign Recent Launches