Our GitHubGitHubGitHub 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/ project boards
The Training Team’s efforts have historically been focused on creating content for Learn.WordPress.org in the English language. The Content Localization Foundations project was the team’s first efforts to onboard contributors who speak other languages and translate content into different locales.
Over the course of 5 months, 28 volunteers created 36 pieces of localized content across 10 locales. Additionally, volunteers translated some of the Training Team’s handbook pages related to content translation into 5 locales.
The project achieved some of the objectives initially laid out. Many points were learned that would improve the entry to localizing content on Learn.WordPress.orgWordPress.orgThe 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/. Some necessary changes for the Locale Ambassador role were also identified. The team will continue to iterate on content localization processes to respond to these findings.
The following are what this project achieved in its six month duration from November 2022 to April 2023.
Goal: Translate 10 priority learning content into each target language (Inclusive of Lesson Plans, and Tutorials)
Completed: The team translated the following pieces of content:
Translations waiting review
Translated handbook pages
1 Lesson Plan
4 Lesson Plans, 1 Tutorial
6 Lesson Plans
1 Lesson Plan, 2 Tutorial
2 Lesson Plans
1 Lesson Plan
1 Online Workshop
1 Lesson Plan
6 Lesson Plans
20 Lesson Plans, 4 Tutorials, 1 Online Workshop
2 Lesson Plans, 9 Tutorials
Number of content translated, by locale
Learnings: The project wasn’t able to translate 10 pieces of content in any one language.
Part way through, the project recognized the process of translating a Tutorial (recording and editing a video) was more involved than most translators were able to contribute to. The project changed priorities to translating Tutorial subtitles instead, but not early enough to reach the goal of “10 pieces of translated content” in any locale.
Next steps: Continue translating content in different locales, but focus on text-based content as a priority.
Onboarding and Documentation
Goal: Create a workflow of onboarding and how-to guides that take folks through the journey of joining the Training Team to publishing localized content
Learnings: Feedback was provided on how it was difficult for many contributors to track translation items in GitHubGitHubGitHub 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/ amongst other content creation issues.
Additionally, we received mixed feedback regarding using GitHub to manage translations. In general, those with experience using GitHub found the documented processes easy to follow. At the same time, others with little/no experience using GitHub showed hesitation to getting involved.
Next steps: To make tracking issues easier, we can move content localization issues into their own GitHub project board.
As for the perceived difficulties of GitHub itself, we can either improve the current onboarding to provide more assistance, or the team can consider using a different tool to manage translations (such as translation plugins, or Computer Assisted Translation tools). This is something the team will investigate further.
Goal: Bring in at least two new Training Team Members from the following locale communities: Spanish, Japanese, German, French, and Italian
Results: The project had 28 contributors across 10 locales that contributed to publishing content.
Next steps: These results encourage the Training Team to continue having a presence at different events – especially WordCamps and Contributor Days – where the team can present the need for content localization to different communities.
Enlisting Locale Ambassadors
Goal: Establish the Locale Ambassador role. Enlist at least five Locale Ambassadors.
Completed: The Locale Ambassador handbook page was published. 6 contributors (in 5 locales) volunteered to be Locale Ambassadors for this project. Of these, 2 locales were able to publish content.
Notably, @piermario and @margheweb did a fantastic job as Italian Locale Ambassadors. They actively onboarded contributors and translation reviewers. They also represented the Training Team at Contributor Day at WordCamp Torino, leading a table focused on translating content for Learn.WordPress.org.
Learnings: The project received the following feedback about the Locale Ambassador role:
Some are hesitant at joining the role as its definition includes a broad range of responsibilities. (A Locale Ambassador is someone who bridges their local community and the Training Team through various initiatives such as, but not limited to: bringing contributors into the Training Team, onboarding contributors to the Training Team’s processes and providing language support, creating localized content.)
Some would become a Locale Ambassador if they weren’t alone in the role in their locale.
Currently, Locale Ambassadors continue to rely on Faculty Administrators to triage GitHub issues or provide translators with website access, causing a bottleneck in the translation process.
Next steps: The project suggests renewing the Locale Ambassador role in the following ways:
Renaming the role to “Translation Coordinators” to better describe the main focus of the role.
Positioning “Translation Coordinators” as a fifth role in the Faculty Program.
While this adds a vetting process to joining the role, it will provide the role with the same GitHub/website access as Faculty Administrators, empowering them to conduct the various tasks that currently rely on an Administrator to perform.
It will also connect Translation Coordinators with others already in the Faculty program, providing better support.
Goal: Enable locale tagging for Courses, Tutorials, and Online Workshops
Goal: Have localized content show first on the Learn WordPress homepage when someone visits the page in their native locale
Completed: Localized Tutorials show on the homepage when viewed in a locale that has one.
While this project will now be closed, the need to localize content on Learn.WordPress.org continues. The project suggests the Training Team continue to iterate on the content localization process, starting with these points:
Renew the Locale Ambassador role as a fifth Faculty role: “Translation Coordinators”.
Focus localization efforts on text-based content.
Create a dedicated project board within the team’s GitHub repository to track content localization.
Continue raising awareness of the localization needs of Learn.WordPress.org at events.