Skip to content

Latest commit

 

History

History
174 lines (131 loc) · 6.51 KB

PEERS_GUIDELINES.md

File metadata and controls

174 lines (131 loc) · 6.51 KB

Peer Guidelines

Translated content

Policies for community maintenance teams

Reviewing and issue queue

It is the responsibility of the active community maintenance team for each active locale to keep up-to-date with reviews of pull requests and handling issues filed against that locale. You can filter the relevant pull requests and issues for each locale using the relevant label — l10n-fr, l10n-ja, l10n-ko , l10n-pt-br, l10n-ru, and l10n-zh.

Requirements for keeping locales up-to-date

Active community maintenance teams are expected to keep their locales maintained and reasonably up-to-date. This means:

  • Reviewing and actioning all pull requests within 2 weeks.
  • Triaging and fixing all actionable issues within 1 month.
  • Making reasonable progress on keeping MDN’s Tier 1 content (definition TBD) synchronized with the en-US versions. This means some progress should be made each week, e.g. updating an article to be in sync with the English version, removing or fixing a bad quality article…

If no progress is made on a locale in these areas within 1 month, the locale will be considered inactive, and edits will stop being accepted.

Review teams

The review teams for each locale are:


Synchronization with the en-US document structure

Periodically we synchronize all the localized document tree structures with the en-US tree structure (English slugs only), to make the documentation easier to manage. When documents are removed from en-US it results in orphaned documents within a sub-directory of each locale folder.

Active locale maintenance teams are invited to spend some time exploring the orphaned documents, to see whether any of this work is worth keeping (either adding to, or merging with an existing document in, the main tree), or whether it can just be deleted.

When a synchronization occurs maintenance teams are given two weeks to decide what to do with the affected documents in their locales to keep things in sync.

Note: Conflicting docs are often created during the sync operation when en-US documents get merged — for example if Foo/Bar becomes just a section inside Foo, and we redirect Foo/Bar to Foo#Bar. This will result in a conflict as the sync job tries to move the translated Foo/Bar to Foo according to the redirect, but Foo already exists.


Activating a locale

To activate a locale you must apply with the following information:

Your locale

Please specify which of the following three locales you wish to have unfrozen:

  • Spanish (es)
  • German (de)
  • Polish (pl)

NB These are the only frozen locales we will consider - see The future of MDN localization in this Hacks post

Your team members

You need to put together a community maintenance team. This requires:

  • A team lead who will be the communication point between that team and the MDN core team, and have overall responsibility for the team.
  • At least two other members, so that members can review other members work.
  • A place to discuss this team's localization work. This can be a Telegram group, Matrix chat room, or whatever the team thinks is best.

To find out more about our existing teams see Review teams above.

Agree to our terms

Please indicate that you agree to our Requirements for keeping locales up-to-date above.

The team agrees to our CoC and license

Also indicate that your team agrees to adhere by our Code of Conduct and License (see below)

Acceptance

If the application is been successful you can start work on your locale. See the guidelines for set up in the README.

You can add your team to the localizing MDN page.

Get in touch

If you want to ask questions or talk to us about forming a new community maintenance team, see ask for help.


Code of Conduct

Everyone participating in this project is expected to follow our Code of Conduct.

License

When contributing to the content you agree to license your contributions according to our license.