Agenda for Docs Team Biweekly Meeting (06-Aug-2024)

The next meeting is scheduled with the following details:

WhenTuesday, 06-Aug-2024 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.

Localization and translation of HelpHub during WCEU 2024

The team working on the localization and translation of end-user documentation (HelpHub) will meet again 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/. at WCEU on Thursday 13 June at 12:30 UTC. Location will be announced at contributor day.

The agenda is as follows:

Goal: Create a plan of how to move forward with the localization/translation of documentation project

  1. Discussion: Cross-team communication
  2. Discussion: What does GlotPress need to move forward. GlotPress has a translation memory, but it’s not context-aware. This makes automated reuse of shorter strings harder.
  3. Discussion: Can we use GH as a docs issue tracker, in the same way global does it? Or can we take advantage of the global docs issue tracker and create labels for languages? How are other teams doing it? Spanish team started with this: https://github.com/orgs/WordPress/projects/195
  4. Request: What does 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. need to prepare Rosetta sites for the documentation page, First discussion: https://meta.trac.wordpress.org/ticket/7637

For background information, please read:

Future plans for HelpHub

Translation of End-user documentation project started at WordCamp Torrelodones (Spain)

Anyone interested in the project is welcome. If you are not attending WCEU, we will be taking live notes in #polyglots-multilingual-community on Slack

Props to @courane01, @javiercasares and @tobifjellner for reviewing the agenda.

Agenda for Docs Team Biweekly Meeting (16-April-2024)

The next meeting is scheduled with the following details:

WhenTuesday, 16-April-2024 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 subsequent triage.
  4. Project check.
  5. Estela’s (@estelaris) updates
  6. Open floor.

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

#agenda, #docs, #meetings

Translation of End-user documentation project started at WordCamp Torrelodones (Spain)

During the 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/. 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. Torrelodones 2024, the Spanish documentation team started the translation for the end-user documentation.

The initial objectives were:

  • Decide the day and time for the weekly team meeting
  • Define responsibilities for meeting facilitators
  • Technical requirements for a documentation team member
  • How to effectively coordinate with the Spanish translation team
  • Review the Style Guide for translation
  • Define the translation process
  • Suggest new words to the Spanish (Spain) Glossary

Conclusions of the Spanish documentation team

Weekly meetings

Responsibilities for meeting facilitators

  • The team agreed that @estelaris will run the first few meetings and then it will be rotated among contributors
  • Whoever runs the meeting must prepare the agenda based on the previous meeting

Contributor technical requirements

  • Know sufficient English to understand the content that is being translated
  • Be familiar with the Spanish style guide and glossary
  • Basic understanding of 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/

Translation Style Guide

Another goal is to improve the Spanish Style Guide to be able to write the documentation, following the rules already instilled by the translation team. This work will be based on the Documentation Style Guide written by the global team. Follow the work in GitHub Spain Handbook #288.

Translation process

The translation process the team will follow includes:

  • Update the style guide and have it reviewed and approved by the translation team
  • Prioritize articles for translation (high, medium, low) as well as add tasks to the issues (content, screenshots, videos, etc)
  • Work with #meta team to open the es.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//documentacion site
  • Translate the articles and pass them to the Spanish 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/. for review
  • Make the documentation available in Spanish from Spain as soon as the site is set

This post will be updated accordingly and it is a translation of the post in Make Spain Blog.

props to @josepmoran for taking notes during contributor day and to help write this post in Spanish

#contributor-day

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

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

Please also see Contributor Day — 26 March, 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 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

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

Agenda for Docs Team meeting January 9, 2024

The next meeting is scheduled with the following details:

WhenTuesday, 9 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

Agenda for Docs Team meeting December 5, 2023

The next meeting is scheduled with the following details:

WhenTuesday, 5 December 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. 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

Summary for Docs Team Meeting (7-Nov-2023)

Attendance

@milana_cap @leonnugraha @sagargurnani @ninianepress @anandau14 @webcommsat @rashiguptaa @zunaid321. Async: @nalininonstopnewsuk, @611shabnam, @femkreations

Housekeeping

Find the complete Transcript of the meeting on Slack.

Upcoming Meeting

Project Checks

@milana_cap had created 48 good first issues for WordPress 6.4 documentation and ran 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/ roles onboarding session. The recording is uploaded to wordpress.tv but not published yet.

@webcommsat gave an update on WordPress 6.4 release documentation:

(Update – link to full update in the meeting and how contributors can help, including working on or reviewing screenshots, video, new explanations. Highlighted the value of docs in this area to the end user.)

  • Documentation tracker for 6.4
  • Dev notes: one additional dev note has been added to the Editor Miscellaneous Dev Notes today
  • There is one remaining Dev Note which will be done after the release by one of the committers
  • Call for contributors to work on HelpHub
  • Props for all those who had contributed by the beginning of last week have been collated, checked against the main list, and submitted
  • A further props update will be sent once the End User docs (HelpHub) have been updated
  • Ongoing outreach and promotion, particularly the HelpHub end user docs
  • Onboarding / support to cohort and additional volunteers
  • Following up work on End User docs.

@atachibana reviewed one issue #1204, and tackled high priority 6.4 issue #1204, the Site Editor Pattern.

@anandau14 worked on one high-priority task and has 2 more assigned.

Open Floor

@webcommsat raised from experience of the last couple of releases and involvement in CoreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress., Marketing, Docs, and Training, a resource to help meetups devote a session to helping with User docs would be very useful and raise awareness about docs. More on this suggestion, what has been started in 6.4, and the fuller discussion 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/.. (link to Slack discussion added)

The ideas included to get meetups and companies to sign-up to help earlier in the release cycle, show how fun it can be, and promote our contributor events.

#docs, #meetings, #summary