Explorations for a notification form between documentation and Rosetta sites

As a member of the docs team, I have been researching how the docs team makes RosettaRosetta The code name of the theme for the local WordPress sites (eg. bg.wordpress.org is a “Rosetta” site). All locale specific WordPress sites are referred to as “Rosetta sites.” The name was inspired from the ancient Rosetta Stone, which contained more or less the same text in three different languages. sites aware of new end-user documentation articles. 

The focus is entirely on the notification issue and not on how to translate or what tools to use for translation.

Goal: Add a way to notify polyglots teams when the docs team adds new or updates articles within wordpress.org/documentation/.

Short-term solution: Create inventories 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 local teams (I will start with the teams that already have GH repositories to work with.)  Since I am still researching the pros/cons and how to make it happen, I will use the Spanish local GH as my first test group. If it works, then I will write about the results and see if it is possible to implement in other localesLocale Locale = language version, often a combination of a language code and a region code, for instance es_MX denotes Spanish as it’s used in Mexico. A list of all locales supported by WordPress in https://make.wordpress.org/polyglots/teams/. As a reference, this is the global End-User documentation Inventory (still in the works.)

Long-term solution: After a chat with the feature-notifications team, they said that the 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 they are building may be a solution. Before you start jumping up and down, I need to add that the developers working on the feature are unfamiliar with Rosetta sites and of course, would like to learn more about the 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/. requirements and need more contributors to help out. My proposal is to open a table at WCEU to work on the feature-notification with polyglots. So instead of filling the feature-notifications 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 with comments, I would recommend that polyglots write up a proposal (the what and how it should work) and bring it to WCEU. Since I am not a developer, I am pretty useless in this area but am happy to collaborate in any way I can. And anything that would be needed from the docs team, I will make it happen. 

Goal: create a workshop, perhaps in video, so every localeLocale Locale = language version, often a combination of a language code and a region code, for instance es_MX denotes Spanish as it’s used in Mexico. A list of all locales supported by WordPress in https://make.wordpress.org/polyglots/teams/ can create the new documentation sitemap in their sites. The workshop focuses on the meaning of each categoryCategory The 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging. and an exercise to categorize the articles. 

The idea is to create tools to make the transition easier. The workshop is already written and I will implement it this weekend at WCBarcelona and adjust as needed afterwards.

Any feedback you could give me on any of the items above would be much appreciated as it will help me take this further and make sure that changes are made as needed.