Help Translate Block Patterns

The Pattern Directory displays a range of block patterns available

You may have noticed a few new projects on Translate: Patterns and Meta > Pattern Directory. These projects were created to help provide a localized version of the new 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. Pattern Directory.

The Pattern Directory will act similarly to the Theme and 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 directories, allowing users to search for unique block patterns to use on their sites via https://wordpress.org/patterns/.

Block patterns are a streamlined way to add pre-designed block layouts to your site. As both the use and features of block patterns expand, the Pattern Directory is expected to launch along with the upcoming July 20th, 2021 WordPress 5.8 release. 

Help Translate the Block Patterns

After the WordPress 5.8 translation is complete, you can help to create a localized experience of this new feature by translating the Block Patterns included in the new directory via:

https://translate.wordpress.org/projects/patterns/core/

This is a great project to encourage new or not currently active translation contributors to get involved in! Many Patterns have a small number of stringsString A string is a translatable part of the software. A translation consists of a multitude of localized strings., and it’s very easy to find the context – the References section shows a link to preview the Block.

Though patterns will be called from coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. WordPress via search in the Block Editor in the future, the translation percentage of the above project does not affect the core release threshold. In other words, the highest priority for translations remains the same: releasing the core language pack.

The Block Pattern Directory itself can also be translated via Meta > Pattern Directory.

Please note there still are some open issues around i18nInternationalization Internationalization (sometimes shortened to I18N , meaning “I - eighteen letters -N”) is the process of planning and implementing products and services so that they can easily be adapted to specific local languages and cultures, a process called localization. This is the process of making software translatable. Information about Internationalization for developers can be found in the Developer’s handbooks. of the directory (RTL, categoryCategory The 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging., strings in .jsonJSON JSON, or JavaScript Object Notation, is a minimal, readable format for structuring data. It is used primarily to transmit data between a server and web application, as an alternative to XML. file are not deployedDeploy Launching code from a local development environment to the production web server, so that it's available to visitors. yet).

What’s coming next

The future of the Block Pattern Directory will include third-party, user-generated block patterns. The mechanism for translating these block patterns has not been finalized. This is a great time to follow the related conversations and help weigh in on the future of how to translate user-generated block patterns.

There are a few possibilities being discussed, including:

  • Building a 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/ picker in the Block Pattern Directory to filterFilter Filters are one of the two types of Hooks https://codex.wordpress.org/Plugin_API/Hooks. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output. block patterns by language, i.e. https://ja.wordpress.org/patterns/ 
  • Creating a localized copy of each locale, similar to forking an existing block pattern.

Conversation around how to translate user-generated block patterns in the future is happening on this proposal from @tellyworth, and will continue to happen in #core and #core-editor chats in the future. Updates on these discussions will also be included in the regular Polyglots weekly meetings and on the Make/Polyglots blog as well.

Thanks to @nao and @dd32 for helping to write this post!

#announcement

WordPress 5.8 ready to be translated

WordPress 5.8, planned for July 20, 2021, is now ready to be translated on translate.wordpress.orgtranslate.wordpress.org The platform for contributing to the translation of WordPress core, themes and plugins.!

The new stringsString A string is a translatable part of the software. A translation consists of a multitude of localized strings. are in the development projects. The strings for WordPress 5.7 have been moved to projects/wp/5.7.x.

As for previous releases, most of new strings are related to updates to the 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. Thus existing translations 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/ project have been copied to the WordPress project. So far there are ~90 (+350 if Gutenberg project was not translated) new strings and ~80 strings had a partial match and thus marked as fuzzy.
Strings for the updated about page should follow soon.

Happy translating! 🌏🌍🌎

A note for 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/ which have also translated wp-config-sample.php and/or readme.html: There were some slightly wording updates which you may want to adopt in your localized file. You can find the changes in this and this changeset (green means new).

#5-8, #announcement

WordPress 5.7.2 has been released

WordPress 5.7.2 has been released. It is a security release. There are no stringString A string is a translatable part of the software. A translation consists of a multitude of localized strings. changes in the main project.

In order to benefit from the automated release process it could be possible that you have to prepare your 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/ first.

In order to benefit from the automated release process make sure that your locale is prepared.

Also released: 5.6.4, 5.5.5, 5.4.6, 5.3.8, 5.2.11, 5.1.10, 5.0.13, 4.9.18, 4.8.17, 4.7.21, 4.6.21, 4.5.24, 4.4.25, 4.3.26, 4.2.30, 4.1.33, 4.0.33, 3.9.34, 3.8.36 and 3.7.36.

#5-7, #announcement, #release

WordPress 5.7.1 has been released.…

WordPress 5.7.1 has been released. It is a security and maintenance release. There is one stringString A string is a translatable part of the software. A translation consists of a multitude of localized strings. change in the main project.

In order to benefit from the automated release process it could be possible that you have to prepare your 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/ first.

In order to benefit from the automated release process make sure that your locale is prepared.

Also released: 5.6.3, 5.5.4, 5.4.5, 5.3.7, 5.2.10, 5.1.9, 5.0.12, 4.9.17, 4.8.16, 4.7.20. Versions 5.2.10 and lower do not include string changes.

#5-7, #announcement, #release

WordPress 5.7 ready to be translated

WordPress 5.7, planned for March 9, 2021, is now ready to be translated on translate.wordpress.orgtranslate.wordpress.org The platform for contributing to the translation of WordPress core, themes and plugins.!

The new stringsString A string is a translatable part of the software. A translation consists of a multitude of localized strings. are in the development projects. The strings for WordPress 5.6 have been moved to projects/wp/5.6.x.

Some of the new strings are related to updates to the 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. Thus existing translations 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/ project have been copied to the WordPress project. So far there are 280 new strings and 30 strings have been fuzzied. Strings for the updated about page should follow soon.

Happy translating! 🌏🌍🌎

Required translation status for coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. language packs

On a related note, the requirement to have WordPress 100% translated before a language pack is built has been updated. From today on the new requirements are as follows:

Related handbook pages have been updated accordingly (onetwothree).

This should give teams with less contributors a better chance to get WordPress released into their 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/ to hopefully attract new contributors to join the team to help finishing the translations of WordPress core and other projects.

WordPress 5.6 is now available in 76 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/ 🚀

For some background information see the comments on this proposal.

#announcement #5-7

WordPress 5.6 ready to be translated

WordPress 5.6, planned for December 8, 2020, is now ready to be translated on translate.wordpress.orgtranslate.wordpress.org The platform for contributing to the translation of WordPress core, themes and plugins.! The deadline for the final stringsString A string is a translatable part of the software. A translation consists of a multitude of localized strings. is set to November 17th.

The new strings are in the development projects. The strings for WordPress 5.5 have been moved to projects/wp/5.5.x.

Some of the new strings are related to updates to the 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. Thus existing translations 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/ project have been copied to the WordPress project. So far there are only 236 new strings and 47 strings have been fuzzied.

WordPress 5.6 will also introduce a new theme – Twenty Twenty-One – which you can translate in projects/wp-themes/twentytwentyone.

To report errors with strings in Twenty Twenty-One please use the Twenty Twenty-One GitHub repo, for the block editor you can use the Gutenberg GitHub repo, and any other component can be reported on WordPress Core Trac.

Happy translating! 🌏🌍🌎

#announcement #5-6

WordPress 5.5 ready to be translated

WordPress 5.5, planned for August 11, 2020, is now ready to be translated on translate.wordpress.orgtranslate.wordpress.org The platform for contributing to the translation of WordPress core, themes and plugins.!

The stringsString A string is a translatable part of the software. A translation consists of a multitude of localized strings. are in the development projects. The strings for WordPress 5.4 have been moved to projects/wp/5.4.x.

As usual, a few of the new strings are related to updates to the block editor. Thus existing translations 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/ project have been copied to the WordPress project. The same was done for the WordPress Auto-updates feature pluginFeature Plugin A plugin that was created with the intention of eventually being proposed for inclusion in WordPress Core. See Features as Plugins., also part of WordPress 5.5.

Happy translating! 🌏🌍🌎

#announcement #5-5

Enhanced file references list for WordPress Core projects

The translatable stringsString A string is a translatable part of the software. A translation consists of a multitude of localized strings. of WordPress coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. are split into four projects: Front end, Administration, Admin Network and Continents & Cities. To avoid the need for translating strings twice or more when they exist in multiple projects they are merged into the project with the initial occurrence.

Until now you wouldn’t know for sure if a stringString A string is a translatable part of the software. A translation consists of a multitude of localized strings. is only used in the front-end project or if it’s also used in the admin because the extracted file references were only for the first string occurrence.

To solve this the string extraction has been updated to preserve the references and comments during the merge task, allowing you to view the full list of file references. Following an example of a string that’s available for translation in the front-end project but is also used in the admin:
references

#announcement

Translation Editor & Locale Manager Vetting Criteria Page Draft

I’ve drafted a handbook page called “Translation EditorTranslation Editor Translation editors can approve translations for projects. The GTE (General Translation Editor) and LM (Locale Manager) roles can add new users with the "Project Translation Editor" role that can approve translations for specific projects. There are two different Translation Editor roles: General Translation Editor and Project Translation Editor & 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/ Manager Vetting Criteria” in an effort to 1) provide more clarity on how global mentors assign PTEProject Translation Editor A Project Translation Editor (often referred to as PTE) is a person, who has access to validate strings on a specific project (for example BuddyPress, WooCommerce or Twenty Fourteen) for one specific locale. A project translation editor can approve strings that are added by translation contributors. Per project translation, editors are appointed by a general translation editor after a request by the project author or by the contributors themselves./GTEGeneral Translation Editor A General Translation Editor (often referred to as GTE) is a person, who has global access to validate strings on all projects for a specific locale./Locale Managers and 2) help locale teams set their own guideline.

Thanks, @tobifjellner @lidialab @evarlese @gperch for your initial feedback on the Google Doc.

There are some items that I’m still not sure if this page should include. Please leave a comment with your thoughts.

Keep in mind we are trying to come up with a minimum set of criteria as a guideline, rather than covering all the best practices and expectations.

  1. “(PTE) may suggest improvements of source texts back to the relevant developers”
    • I think this is a nice-to-have quality for a PTE but doesn’t have to be a requirement for a first-time PTE. I wouldn’t turn down someone from becoming a PTE just because they haven’t learned how to do this.
  2. “(PTE) joins the Global Make WordPress Slack via https://make.wordpress.org/chat/ & Locale specific Slack”
    • Same as above, I don’t think not being on global/local 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/. is a blocker. I’d still grant someone a PTE role without joining Slack.
  3. “Role Removal Process” section
    • I added this section that was not in the Gdocs draft.

I will remove the callout saying “This handbook is still in progress” on the handbook page once we sort out the above items.

#documentation #announcement

Updated documentation for localized release packages

This is a short announcement for an update on the documentation for the release process of WordPress release packages with translations. The following handbook pages have been updated/created:

The overall recommendation remains unchanged: Ensure that 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/ is always eligible for automated release packagesAutomated Release Packages Automated release packages are release packages of locales that have no custom changes..

As of today all 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/, with only one exception, are already using automated release packages. 👏 To reflect this status in the handbook the documentation has been restructured and updated by removing outdated information and replacing complex descriptions with shorter and simple question/answer sections.

Here’s a summary of the updates:

  • The documentation for manual release packages has been moved into a separate page with a warning that it’s no longer actively supported.
  • The requirements for automated releases packages have been simplified into three simple rules:
    • Never had any custom changes
    • No custom changes for the current stable version
    • Minor custom changes for the current stable version
  • When working with the Translation Repository:
    • It’s no longer recommended to use the tags/ directory, only branches/ and trunk/. All existing tags already have been removed.
    • It’s not allowed to use the repositoryWordPress Localization Repository The WordPress Localization Repository at https://i18n.svn.wordpress.org/ is a Subversion repository where official WordPress translations are maintained. See Working with the Translation Repository for details. for other directories/files which are not related to WordPress coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress..
    • If you have made changes like a translated readme.html oder wp-config-sample.php you’re also responsible to keep up to date with the latest development and update the files accordingly.
    • It’s required that any by default included plugins are also hosted on the WordPress 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 Directory. They also must be declared as compatible with the latest stable WordPress release. Otherwise the plugin must not be bundled with the localized release packageRelease package release package is a packaged version of WordPress. That is, a ZIP file consisting of WordPress in its entirety, along with PO and MO files for core, the PO and MO files of default themes and Akismet, and any custom changes a locale has. In the past, most locales built their release package using the form in Rosetta’s dashboard..

Those rules exist to ensure the continued quality standard of the default WordPress release packages and to release localized release packages as fast as possible after an official WordPress release.

#announcement, #handbook

Back to 200 locales and new filters on translate.wordpress.org

After a small cleanup of unused 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/ at the end of last year, the team is happy to announce that we’re back to 200 available locales in WordPress. Please welcome the recent additions of

There’re still some requests in the pending queue and we hope to process them as soon as possible to continue increasing the list of 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/ teams.

Changes on translate.wordpress.orgtranslate.wordpress.org The platform for contributing to the translation of WordPress core, themes and plugins.

Last week the translation platform got an update:

New translation views for tables give a better overview over the currently selected filterFilter Filters are one of the two types of Hooks https://codex.wordpress.org/Plugin_API/Hooks. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output..

A view to show only translated stringsString A string is a translatable part of the software. A translation consists of a multitude of localized strings..
A view + count for the currently filtered strings.

The filters have been extended to allow limiting the term search by scope. For example search only in originals or only in references.

Use term scope and new options to further limit the strings.

Want to show only the translations that have a plural form? Now you can with the new “With plural” filter option.

Submitting a translation containing the UTF-8 characters → and ↵ is now possible. Very useful for the recently introduced “A → Z” stringString A string is a translatable part of the software. A translation consists of a multitude of localized strings. in the 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.

No limits anymore, just use → when you want.

And many other fixes:

  • Remove default sorting for untranslated view.
  • Highlight glossary terms on translation previews.
  • Fix multi-select for forward and backwards selections.
  • Fix mangled HTMLHTML HTML is an acronym for Hyper Text Markup Language. It is a markup language that is used in the development of web pages and websites. tags in originals with some glossary entries.
  • Fix duplicate glossary tooltips for the same term.
  • Fix import of escaped unicodes in Android strings files.
  • Fix incorrect key in Apple strings file exports.
  • Fix querying translations by priority. 
  • Improve calculation of translation status counts.
  • Prevent adding duplicate glossary entries. 
  • and even more.

#announcement

WordPress 5.4 ready to be translated

WordPress 5.4, planned for March 31, 2020, is now ready to be translated on translate.wordpress.orgtranslate.wordpress.org The platform for contributing to the translation of WordPress core, themes and plugins.!

The stringsString A string is a translatable part of the software. A translation consists of a multitude of localized strings. are in the development projects. The strings for WordPress 5.3 have been moved to projects/wp/5.3.x.

So far there are around 400 stringString A string is a translatable part of the software. A translation consists of a multitude of localized strings. changes. This already includes strings for the about page.
While string freezeString freeze The term "string freeze" is used by the core team to mark the end of changes to the strings of an upcoming release. A string freeze also means that there will be no more strings added to the core project. Sometimes a string freeze has two phases a soft freeze and a hard freeze. A string freeze is announced on the Polyglots blog by the current release lead. has been announced, depending on the severity changes may still occur.

A few of the new strings are related to updates to the block editor. Thus existing translations have been migrated to the WordPress project.

ℹ️ A good starting point is the Fuzzy view since many strings have been changed to use sentence case. This may not apply to your 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/ so you can bulk approve many of them.

Happy translating! 🌏🌍🌎

#announcement #5-4

WordPress 5.3 ready to be translated

WordPress 5.3, planned for November 12, 2019, is now ready to be translated on translate.wordpress.orgtranslate.wordpress.org The platform for contributing to the translation of WordPress core, themes and plugins.!

The stringsString A string is a translatable part of the software. A translation consists of a multitude of localized strings. are in the development projects. The strings for WordPress 5.2 have been moved to projects/wp/5.2.x.

So far there are around 380 stringString A string is a translatable part of the software. A translation consists of a multitude of localized strings. changes. The about page has not been updated yet. Soft string freezeString freeze The term "string freeze" is used by the core team to mark the end of changes to the strings of an upcoming release. A string freeze also means that there will be no more strings added to the core project. Sometimes a string freeze has two phases a soft freeze and a hard freeze. A string freeze is announced on the Polyglots blog by the current release lead. is announced for next week, October 7th.

Most of the new strings are related to an update of the 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 (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/). Existing translations have been migrated to the WordPress project.

WordPress 5.3 will also bundle a new default theme, called Twenty Twenty. Active development still happens on GitHub.
Twenty Twenty can be translated in the projects/wp-themes/twentytwenty project.

Happy translating! 🌏🌍🌎

#announcement #5-3

HelpHub & Handbook i18n Updates

Last edition: https://make.wordpress.org/meta/2019/06/20/helphub-handbooks-localisation/

HelpHub

HelpHub is a future home for all of the WordPress user documentation currently residing in the WordPress CodexWordPress Codex Living online manual to WordPress.org https://codex.wordpress.org/. Example of a HelpHub page: https://wordpress.org/support/article/overview-of-wordpress/

Since the last update, the docs team decided to turn on the HelpHub feature on Japanese & Serbian 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. site first as a trial.

After the trial period, it will be activated on all Rosetta sites that have active /support section.

Currently, there is no sync mechanism between the original English content and the translation. We are also talking with Docs team about how we handle the change notification process #.

Next Steps

  • 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. Team will be helping with content import (ref) to prepare for the teams that want to have a copy of the original English documents.
  • 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/ teams: let’s start discussing how we are going to collaborate in translation & keep track of the progress.

Handbook

Handbook on Rosetta site is a section under the /team/ P2p2 "p2" is the name of the theme that blogs at make.wordpress.org use (and o2 is the accompanying plugin). When asked to post something "on the p2" by a member of the Polyglots team, that usually means you're asked to post on the team blog https://make.wordpress.org/polyglots/. (o2p2 "p2" is the name of the theme that blogs at make.wordpress.org use (and o2 is the accompanying plugin). When asked to post something "on the p2" by a member of the Polyglots team, that usually means you're asked to post on the team blog https://make.wordpress.org/polyglots/.) where you can create sets of documentation with a menu sidebarSidebar A sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme.. Example of a handbook on Rosetta site: https://ja.wordpress.org/team/handbook/

If your Rosetta site has a /team/ site already, the handbook will be automatically activated. If you need to have a /team/ site activated, post a request on this (polyglots) P2.

Information and example localized handbook can be found in the FAQ page in Polyglots Handbook.

Next Steps

  • Locale teams: decide which handbook(s) to translate and how to translate them.
  • We need to put together more information on how it works (e.g. ordering pages, creating multiple handbooks)

#announcement

Proposal for handling PTE requests

At WCEU, @petya, @nao, @casiepa, and @ocean90 have discussed the future of PTEProject Translation Editor A Project Translation Editor (often referred to as PTE) is a person, who has access to validate strings on a specific project (for example BuddyPress, WooCommerce or Twenty Fourteen) for one specific locale. A project translation editor can approve strings that are added by translation contributors. Per project translation, editors are appointed by a general translation editor after a request by the project author or by the contributors themselves. requests.
The goal is to move them in a separated place (but still on this p2p2 "p2" is the name of the theme that blogs at make.wordpress.org use (and o2 is the accompanying plugin). When asked to post something "on the p2" by a member of the Polyglots team, that usually means you're asked to post on the team blog https://make.wordpress.org/polyglots/. site) and have the data of each request in a more structured format available.

Here are the notes:

Form to collect the data

Instead of the free form textarea we ask for the data via a form:

  • Maybe: Ask if 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/author or translators
  • Select plugin/theme slugs (autocomplete)
  • Select 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/(s)
  • List contributor(s) per locale
  • Form can be submitted by the theme/plugin author but also contributors
  • Request can include many projects/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//contributors

Validate the data

  • Does the contributor exist? (error)
  • Are the locales correct? (error)
  • Are the plugins/themes available?
  • Pre-requirements
    • Does the contributor have submitted at least 5? translations for the requested projects in the locale? (warning)
    • Check number of requested locales, maybe CLPTECross-locale Project Translation Editor A Cross-Locale Project Translation Editor is an account owned by a plugin or theme author (or the authoring organization), which uses professional translators to localize their product. The cross-locale project translation editor can import/validate strings on a specific project for more than one locale. This role has the same capabilities as a Project Translation Editor over multiple locales instead of one. Cross-Locale Project Translation Editors need to meet a set of criteria before being appointed by General Translation Editors.? (warning)
  • Is the contributor already an approved PTE? => Make they automatically a PTE for the new project?

Store the data in a custom post typeCustom Post Type WordPress can hold and display many different types of content. A single item of such a content is generally called a post, although post is also a specific post type. Custom Post Types gives your site the ability to have templated posts, to simplify the concept.

  • Benefit: Removes the requests from the index page of the polyglots p2

Output of requests

  • Table to list all requests, similar to teams page
  • Split requests into locales
  • Filterable by locale, date, …
  • Notifications to all GTEs
  • Link to the project on translate.w.org with active user filterFilter Filters are one of the two types of Hooks https://codex.wordpress.org/Plugin_API/Hooks. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output.
  • Tell the GTEGeneral Translation Editor A General Translation Editor (often referred to as GTE) is a person, who has global access to validate strings on all projects for a specific locale. whether the user is already a PTE
  • Approve button for GTE without visiting the wp-admin for all GTEs
  • Show some stats about the user
  • Send reminder about requests that are two weeks old, automatically approve a week after the reminder?
  • Post request on the team p2 or just summary/activity log
  • Show comments from team p2 at the global requests (depends on previous point, discussions need to be in English)
  • Show the “Resources for translation contributors” in the request (automated comment, see French, …)
  • Reject with feedback only with predefined reasons (grammar, punctuations, typos, style guide)
  • (Nice to have) Activity log for each new PTE (user x by user y/automatically) on date)

Open TracTrac Trac is the place where contributors create issues for bugs or feature requests much like GitHub.https://core.trac.wordpress.org/. tickets

Next steps

Please let us know what you think about this proposal. Do you have any suggestions or can you provide some mockups for how a list of requests or a detail page of a request can look like? What would be a good minimum viable productMinimum Viable Product "A minimum viable product (MVP) is a product with just enough features to satisfy early customers, and to provide feedback for future product development." - WikiPedia (MVPMinimum Viable Product "A minimum viable product (MVP) is a product with just enough features to satisfy early customers, and to provide feedback for future product development." - WikiPedia), what are the must haves for a first version?
Are you a developer and can help us with the implementation?

Whatever you have, please let us know in the comments. Thank you!

#announcement, #wceu