WordPress.org

Making WordPress.org

Opened 2 years ago

Last modified 2 years ago

#1334 new task

Documentation for the theme and plugin translation process

Reported by: johnbillion Owned by:
Milestone: Priority: high
Component: Translate Site & Plugins Keywords: needs-docs
Cc:

Description

Now that translations are being served live from translate.wordpress.org for all themes and many plugins, it's noticeable that there's a lack of documentation which explains the process to authors of themes and plugins.

The "Language Packs Coming Soon to Your Plugins" email which is being sent to plugin authors doesn't even explain the process at a high level, and assumes some knowledge of what translate.wordpress.org is.

Documentation needs to be added (preferably to the plugin and theme developer handbooks, and then promoted on the make blogs and emails to plugin authors) which explains:

  • What translate.wordpress.org provides
  • Who can add and edit translations
  • The translation approval process
  • Who can and cannot approve translations
  • How a language pack goes live (ie. needs 100% translation)
  • How a theme or plugin appears in localised theme or plugin directory
  • Security and safeguards regarding text that's allowed in translations
  • Where issues with translations should be addressed

In addition, and this is probably covered in a separate ticket, there doesn't appear to be any available notifications so theme and plugin authors can be notified of new, updated, or completed translations, which currently makes the process even more opaque.

Change History (2)

#1 @samuelsidler
2 years ago

This doesn't really need to be a meta ticket and should probably just be a post on make/docs. See also.

This ticket was mentioned in Slack in #polyglots by netweb. View the logs.


2 years ago

Note: See TracTickets for help on using tickets.