Localization and translation of HelpHub – Meeting notes

Attendees: @amieiro  @javiercasares  @glycymeris @battelfred  @estelaris @cbringmann @chanthaboune @nullbyte  @milana_cap  @tobifjellner  @courane01 @emmaht

Agenda: https://make.wordpress.org/docs/2024/06/10/localization-and-translation-of-helphub-during-wceu-2024/

Goal

The goal of this project is to create a process to facilitate and simplify the translation of 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/ documentation into other languages. Perhaps in the future, the same process can be either replicated or used as a starting point for other teams to translate their documentation. 

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? 

Ticket discussion:  https://meta.trac.wordpress.org/ticket/7637

@estelaris reported that the Meta team doesn’t know the scope of adding this page to Rosetta sites currently, as the requirements differ from site to site. 

There are teams like JA(Japanese), FR (French), and IT (Italian) that have a great deal of the documentation already translated but still need the new site maps. Others, like BG (Bulgarian) and RU (Russian), still connect documentation to Codex. LT (Lithuanian) does not have either a support or documentation page. These are the few teams that met at WCEU or have been in touch with the docs team at different times.

Meta tickets will be opened for the sites linked to Codex to make sure everything is documented. It is important that the existing articles in a local language do not get lost.

@estelaris is writing documentation to help the meta team. This documentation includes the steps taken while the global documentation page was created and a spreadsheet with the redirects.

Another issue to consider is that this process will need a dedicated meta team member due to the amount of work involved.

Cross-team communication

The teams working on this project are GlotPress, Docs, Meta, Training, locales, and operations. We are communicating through the  #polyglots-multilingual-community on Slack.

Any updates or related posts will be posted on the Team Updates Make blog and cross-post to the #docs, #meta, #polyglots, and #training Make blogs.

Is the marketing involved in this project?

Not at the moment. The main goal is to focus on one team. Hopefully, the marketing team and other teams can replicate the translation processes developed by this project.

Other projects

Other projects that require translation are the Developer Resources and the Developer’s blog, which are in a subsite under developer.wordpress.org. Meta will need to resolve a very specific issue related to the developer site and that is the URLURL A specific web address of a website or web page on the Internet, such as a website’s URL www.wordpress.org to be used in Rosetta sites. It was mentioned at the meeting that translating the Developer blog is important because it provides timely information for developers.

Then there is Learn. The content from Learn is uploaded directly to the Learn site, and it is not linked to 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/. The training team also stores all languages on one site at this time, and Sensei LMS is not yet compatible with content in multiple languages. 

For the Rosetta sites, the scope for the new page /documentation/ was discussed and needs more feedback, this team should continue working with Meta to understand how to add the developer and other pages. 

What is the process?

These are the steps we would like to test:

  1. Create the project in GitHub.
  2. Translation and revision that all the content from the article is there
  3. Add the translation to GlotPress
  4. Review and approval by GTEs
  5. Post on the local documentation page

As an example, the Spanish team is translating articles from the project created in GitHub [ES] Traducción y localización de la documentación de usuarios finales. The French team has a different process. Until we have the correct tools to work on long translations, a local team should be flexible in its work.

GlotPress

GlotPress is used only to translate strings for themes, plugins, etc., but doesn’t have the capacity to translate long blocks of text. One way could be for each paragraph to be treated as a string.

The GlotPress team needs to create a 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 to import data from different sources and another one to export this data, create new projects, and define a structure inside translate.wordpress.org. Once 90% of the content has been translated, it can be moved to a page.

Screenshots and videos should come from the local site. Jeff Matson built a tool that could automate updating the screenshots with a new version, but the code source and the state of the project are unknown. @courane01 will find out more.

Tasks

Docs team

  1. Finish the documentation for https://meta.trac.wordpress.org/ticket/7637
  2. Continue working with the translation teams to add their redirects

GlotPress

  1. Evaluate what is needed to translate long blocks of text in GlotPress.
  2. Creating a system for segment labeling.
  3. How to maintain versioning of previous translations.
  4. Which URLs work better with GlotPress, English only or English + other language?

Spanish team

  1. Translate at least 20 pages to start testing GlotPress and advise the GTEs.

Operations

  1. @cbringmann will coordinate any extra developer time needed.

Thoughts on GlotPress and GitHub

  • If using GitHub for versioning, is there another tool for labeling how the segments have been changing
  • Split a page into segments to maintain versioning and keep a record of previous versions.
  • Reuse translations as much as possible to avoid additional efforts.
  • Keep segments before and after the ones that are being translated to create context and meaning. That feature is part of professional translation software.
  • GlotPress doesn’t have this capability, perhaps changing the data format from the GetText infrastructure.
  • The Spanish team is finishing a GitHub contributor handbook for beginners. This will help new contributors learn to work with GitHub.
  • The workload is heavy on the reviewers; the documentation team has to decide which tools we will use for translation.
  • The workload for the GTEs will not increase significantly because everything will be in GlotPress.
  • All the text must be on one page, and the paragraphs must be in order.
  • During the translation, we need to compare the English and Spanish/other language versions. There is a problem with that option. When you enter a paragraph, it gets an ID. The problem is that when the English version is updated, we need to add more metadata to the original strings. We will investigate more about this issue.
  • Another issue with GlotPress is that it is string-based. If you have a string that says “no,” it will be translated the same everywhere. This is an issue because “no” can mean several things. It could be the opposite of yes, or it could be used as a shorthand for “number,” or it could mean something else.
  • The same concern shows in plugins and theme translations, but with plugins; one can ask the plugin developer to change one of the strings. With the documentation, the result will be a bad translation.

Versioning

  • The docs team wants to introduce documentation for different WordPress versions, this is a good time to start thinking about this as everything needs to be translated.
  • For instance, the single article is the Navigation 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., now the Navigation menuNavigation Menu A theme feature introduced with Version 3.0. WordPress includes an easy to use mechanism for giving various control options to get users to click from one place to another on a site.. It has changed many times since rolling out the Site Editor. If someone wanted to read the documentation on the Navigation bar at 6.0 because their site uses 6.0, how do we work this out?
  • The Learn team can have a similar issue.
  • The code reference team uses taxonomies to resolve versioning issues.
  • The documentation has the latest version, but now it will add the previous version to the articles. How can this be incorporated into GlotPress?

Multilingual sites

  • There are solutions available to work with multilingual sites, and Phase 4 may occur in 3 or 4 years.
  • Meanwhile, where do we put the information? How do we move the pieces forward and be ready for when the coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. can do it by itself?
  • How do we put the URLs back on the website? This has to be resolved before Phase 4
  • A solution could be having the articles in GlotPress, which can give that page an original ID. When the page is moved to WordPress, the original ID will move with it, but it will also remain as a master ID in GlotPress.
  • The main problem is that we still need to figure out where to store the information before phase 4.
  • To avoid wasting developers’ time, start translating what is available now (the most stable is end-user documentation).

Testing GlotPress

  • The Spanish team is working on the translation of the first categoryCategory The 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging. of end-user documentation and improving the glossary. That is about 20 articles/pages that can be used to test new GlotPress features.
  • Tests can be run from WordPress with the original article.

French community

  • The French community has about 90% of the end-user translated. 
  • Need to cross-reference the articles to create a table of redirects that will help the meta team when adding the fr.wordpress.org/documentation page. This is the only way to maintain what has already been translated.
  • The French translations may need to be updated, as the docs team removed all developer jargon from end-user documentation.
  • Any other information added to the articles must be discussed with the docs team before being added to the global English version or removed from the French article.
  • The articles must be one-on-one between English and other versions of the language.
  • The sitemap has to be translated into French.
  • All of these items are part of the meta ticket mentioned at the beginning of this article.

URLs

  • Since the URLs are all custom and not content, are they going to be translated?
  • The slug is a field in the database.
  • URLs should not be arbitrary but should be translated and not changeable.
  • Perhaps this should be a role responsibility, and only GTEs or locale managers can set it up.
  • What if slugs are not translated? Because there is a decision to be made. What will the correct slug be:
    es.wordpress.org/documentation/ or es.wordpress.org/documentacion/
  • This is another task for meta, which already is es.wordpress.org/support/. The full slug is in English.
  • Presently, the slugs are in 2 languages:
    https://es.wordpress.org/support/forum/manuales-y-resolucion-de-problemas/
  • Using a redirection table that links directly from wordpress.org.
  • Perhaps it is better to maintain all the slugs in English as they can maintain the same IDs, which will make it easier to synchronize.
  • Also, it would be easier to check on the translation status of a page in another language.
  • So if there is a page with a translated slug, we can redirect it only once to the English version (adding the language prefix). If everything is in English, it is easier to maintain.
  • In the long term, it is better to keep everything in English because when translations are not available, the site can remain in English.

Props to @courane01, @javiercasares and @nullbyte for reviewing and editing the notes.

#glotpress, #learnwp

Themes team update July 16, 2024

i) 🎟 Theme directory stats

Currently,

  • 0 new ticket is waiting for review.
    • 0 tickets are older than 4 weeks
    • 0 tickets are older than 2 weeks
    • 0 tickets are older than 1 week
    • 0 tickets are older than 3 days
  • 58 tickets are assigned.
    • 4 tickets is older than 4 weeks
    • 9 ticket is older than 2 weeks
    • 15 tickets are older than 1 week
    • 45 tickets are older than 3 days
  • 0 is approved but is waiting to be made live.

In the past 7 days,

  • 503 tickets were opened
  • 504 tickets were closed
    • 493 tickets were made live.
      • 34 new Themes were made live.
      • 459 Theme updates were made live.
      • 0 more were approved but are waiting to be made live.
    • 11 tickets were not approved.
    • 0 tickets were closed-newer-version-uploaded.

Note: These stats include both the new theme tickets and updated theme tickets as well.

Number of reviewers: 4 (@acosmin@kafleg@vowelweb@fahimmurshed)

ii) 💻 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. Theme Stats

  • 16 Block themes are currently being reviewed
  • 10 Block theme has been live for the last 7 days

iii) 💡HelpScout Stats

In the past 7 days,

Email Conversations 8Messages Received 17
Replies Sent 12Emails Created 0
Resolved 9Resolved on First Reply 56%

iv) 📊Extras

  • Create Block Theme 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 now has 10000+ active installs. There are 49 active issues and 4 Pull requests in GitHub.
  • Theme Check Plugin has 6 PRs and 38 issues.
  • A few themes are suspended because of security reasons.

#themes, #weekly-updates

Community Team Event Updates– July 16, 2024

Here is the quarterly update on our ongoing efforts to support community growth, guided by the Big Picture Goals 2024. Our focus is on helping current contributors and attracting new participants to our events. To that end, this report includes the latest participation rates and event financial activity, highlighting our progress and identifying areas for continued improvement.

As of June 30, 2024

WordCamps & WordPress Events Stats

First-time Attendees (FTA)
41.58% (Target 45%)
(WordCamps and WordPress events, excluding Meetups and Flagship WordCamps)

Events with 50% FTAs
24% (Target 45%)
(Average first-time attendee rate in local WordCamps & WordPress Events this year)

Event Attendee Satisfaction Rate
82.81% (Target 80%)
(Percentage of “Extremely satisfied” or “Satisfied” in WordPress Events post-event survey.)

Number of WordCamps
66
From January 1st to June 30th.
(Active WordCamps and WordPress Events / WordCamps and WordPress Events that have been held or are scheduled to be held)

Number of other WordPress Events
+175.0% (11)

MeetupMeetup All local/regional gatherings that are officially a part of the WordPress world but are not WordCamps are organized through https://www.meetup.com/. A meetup is typically a chance for local WordPress users to get together and share new ideas and seek help from one another. Searching for ‘WordPress’ on meetup.com will help you find options in your area.’s Stats

January 1, 2024 to June 30, 2024

Number of RSVPs
-3.9% (39,013 Growth compared to the same period last year) 

Number of meetup groups
+1.7% (761)

Number of Meetup members
+4.3% (537,597)

Community Team Contributors

As part of the Five for the Future promotion, we will disclose the number of members who contribute to the community team.
60
(The current number of Program Managers, Program Supporters and Event Supporters.)

Financial

Total Global Funds (FY2024)
$725,000

Current Expenses
$174,659

#community-team

Plugin Review Team: 15 July 2024

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 Status Change Stats

  • Plugins requested : 116
  • Plugins rejected : 13
  • Plugins closed : 642
  • Plugins approved : 66

Plugin Queue Stats (current)

  • Plugins in the queue (new and pending)* : 2500
    • (older than 7 days ago)** : 2344
    • (2024-07-08 – 2024-07-14) : 128
    • (new; not processed or replied to yet)* : 643
    • (pending; replied to)* : 1857
    • (pending; waiting on author)* : 1692
    • (pending; waiting on reviewer)* : 143
    • (pending; waiting on reviewer, email not yet sent)* : 22

Help Scout Queue Stats

  • Total Conversations: 1303
  • New Conversations: 505
  • Customers: 847
  • Conversations per Day: 162
  • Busiest Day: Wednesday
  • Messages Received: 622
  • Replies Sent: 1157
  • Emails Created: 376

* : Stat reflects current size of queue and does not take into account ‘date’ or ‘day’ interval
** : Stat reflects activity only within the ‘recentdays’ from today

#plugins

Documentation Team Update – July 15, 2024

The Documentation team meeting schedule:

A new GitHub repo is created for end-user documentation and its translations to all locales. More info about this can be found here.

Documentation Issue Tracker stats.

Current state

By status:

By version:

By project:

Past week

0 pull requests merged.

3 issues closed.

22 issues were created.

Current projects:

The Documentation team repositories:

#docs

Test Team Update: 15 July 2024

Test Ticket Queue 🎟

👉🏻 “(change: N)” represents changes from prior week (unless noted).

📊 Current totals (since July 08, 2024):

  • Need testing info: 19 (change: +0)
  • Need reproduce issue: 2073 (change: +0)
  • Need patch testing: 225 (change: +0)
  • Need unit tests: 109 (change: +0)
  • Need review (have patch and unit tests): 182 (change: +0)

🟢 New/Changed last week:

  • Need testing info: 0 (change: +0)
  • Need reproduce issue: 12 (change: +6)
  • Need patch testing: 12 (change: +8)
  • Need unit tests: 1 (change: +0)
  • Need review (have patch and unit tests): 12 (change: +5)

🟣 Closed last week:

  • Need testing info: 0 (change: +0)
  • Need reproduce issue: 0 (change: -3)
  • Need patch testing: 1 (change: -4)
  • Need unit tests: 0 (change: +0)
  • Need review (have patch and unit tests): 7 (change: +0)

To discuss queries used in this report, please comment below, or connect with the Test Team over in #core-test.

+make.wordpress.org/test/

#test

Themes team update July 09, 2024

i) 🎟 Theme directory stats

Currently,

  • 0 new ticket is waiting for review.
    • 0 tickets are older than 4 weeks
    • 0 tickets are older than 2 weeks
    • 0 tickets are older than 1 week
    • 0 tickets are older than 3 days
  • 52 tickets are assigned.
    • 2 tickets is older than 4 weeks
    • 7 ticket is older than 2 weeks
    • 21 tickets are older than 1 week
    • 40 tickets are older than 3 days
  • 2 is approved but is waiting to be made live.

In the past 7 days,

  • 793 tickets were opened
  • 766 tickets were closed
    • 746 tickets were made live.
      • 53 new Themes were made live.
      • 693 Theme updates were made live.
      • 2 more were approved but are waiting to be made live.
    • 20 tickets were not approved.
    • 0 tickets were closed-newer-version-uploaded.

Note: These stats include both the new theme tickets and updated theme tickets as well.

Number of reviewers: 4 (@acosmin@kafleg@vowelweb@fahimmurshed)

ii) 💻 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. Theme Stats

  • 15 Block themes are currently being reviewed
  • 13 Block theme has been live for the last 7 days

iii) 💡HelpScout Stats

In the past 7 days,

Email Conversations 13Messages Received 19
Replies Sent 10Emails Created 0
Resolved 7Resolved on First Reply 100%

iv) 📊Extras

  • Create Block Theme 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 now has 10000+ active installs. There are 48 active issues and 3 Pull requests in GitHub.
  • Theme Check Plugin has 6 PRs and 38 issues.
  • Twenty Twenty-Five GitHub repository created.
  • A few themes are suspended because of security reasons.

#themes, #weekly-updates

Test Team Update: 8 July 2024

Test Ticket Queue 🎟

👉🏻 “(change: N)” represents changes from the prior week (unless noted).

📊 Current totals (since July 01, 2024):

  • Need testing info: 20 (change: -1)
  • Need reproduce issue: 2076 (change: +0)
  • Need patch testing: 223 (change: -8)
  • Need unit tests: 109 (change: +0)
  • Need review (have patch and unit tests): 181 (change: +7)

🟢 New/Changed last week:

  • Need testing info: 0 (change: -3)
  • Need reproduce issue: 10 (change: +3)
  • Need patch testing: 10 (change: -10)
  • Need unit tests: 1 (change: -1)
  • Need review (have patch and unit tests): 10 (change: -5)

🟣 Closed last week:

  • Need testing info: 0 (change: +0)
  • Need reproduce issue: 3 (change: -1)
  • Need patch testing: 7 (change: +1)
  • Need unit tests: 0 (change: -1)
  • Need review (have patch and unit tests): 7 (change: -3)

To discuss queries used in this report, please comment below, or connect with the Test Team over in #core-test.

+make.wordpress.org/test/

#test

Documentation Team Update – July 8, 2024

The Documentation team meeting schedule:

A new GitHub repo is created for end-user documentation and its translations to all locales. More info about this can be found here.

Documentation Issue Tracker stats.

Current state

By status:

By version:

By project:

Past week

0 pull requests merged.

3 issues closed.

7 issues were created.

Current projects:

The Documentation team repositories:

#docs

Themes team update July 02, 2024

i) 🎟 Theme directory stats

Currently,

  • 0 new ticket is waiting for review.
    • 0 tickets are older than 4 weeks
    • 0 tickets are older than 2 weeks
    • 0 tickets are older than 1 week
    • 0 tickets are older than 3 days
  • 71 tickets are assigned.
    • 6 tickets is older than 4 weeks
    • 17 ticket is older than 2 weeks
    • 33 tickets are older than 1 week
    • 49 tickets are older than 3 days
  • 1 is approved but is waiting to be made live.

In the past 7 days,

  • 872 tickets were opened
  • 887 tickets were closed
    • 873 tickets were made live.
      • 56 new Themes were made live.
      • 817 Theme updates were made live.
      • 1 more were approved but are waiting to be made live.
    • 14 tickets were not approved.
    • 0 tickets were closed-newer-version-uploaded.

Note: These stats include both the new theme tickets and updated theme tickets as well.

Number of reviewers: 6 (@acosmin@kafleg@vowelweb, @dballari, @fahimmurshed, @jamieblomerus )

ii) 💻 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. Theme Stats

  • 17 Block themes are currently being reviewed
  • 23 Block theme has been live in the last 7 days

iii) 💡HelpScout Stats

In the past 7 days,

Email Conversations 12Messages Received 16
Replies Sent 16Emails Created 0
Resolved 16Resolved on First Reply 75%

iv) 📊Extras

  • Create Block Theme 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 now has 10000+ active installs. There are 48 active issues and 2 Pull requests in GitHub.
  • Theme Check Plugin has 6 PRs and 38 issues.
  • Twenty Twenty-Five GitHub repository created.
  • A few themes are suspended because of security reasons.

#themes, #weekly-updates