752626 - Localization Process doc needs to be updated

Status: RESOLVED FIXED

(Mozilla Localizations Graveyard :: Documentation, defect)

Description

[Jeff Beatty [:gueroJeff]]

Process doc on wikimo is outdated and needs updating.

In addition, in light of Khmer community's challenges, some of the doc needs to be explicit about criteria for migrations between release channels.

Comment 1

[Jeff Beatty [:gueroJeff]]

Starting at "Starting a L10n effort," you can navigate through the whole process description using the "Next >>" link at the bottom of each page.

It was not written as a tutorial, but as a compiliation of the ideal practices and process we expect the L10n teams to follow. It contains no technical details (as those are contained in the MDN Quick start guide). In addition, it attempts to identify the division of responsibility between the L10n drivers and the L10n communities. Finally, this doc, in combination with the updates I've made to the MDN Quick start guide cover most of the holes (if not all) encountered by the Khmer team.

Comment 2

[Jeff Beatty [:gueroJeff]]

Specific doc holes identified through Khmer community's challenges that have now been covered by this and other doc:

- Review, sign-off, and post-sign-off process not clear (should be part of both MDN and wikimo)
    - Part of this doc and written on the MDN (https://bugzilla.mozilla.org/show_bug.cgi?id=728066)

- Migration of L10n builds to various dev stages unclear 
    - Cleared up here on page 3.

- Discrepancies between narro dashboard and hg dashboard, as well as narro export issues with missing files, Linux line endings, etc. 
    - included in intermediate Narro tutorial, as well as technical review doc on MDN (see https://bugzilla.mozilla.org/show_bug.cgi?id=728066 and https://developer.mozilla.org/en/Localizing_with_Narro/Intermediate_tutorial).

- Localizng with Mercurial tutorial on MDN needs to include a common pitfalls section (e.g., missing files, Linux line endings, etc.). This could also be included in an advanced Narro tutorial. 
    - Included in intermediate Narro tutorial, as well as technical review doc on MDN.

- Roles were not clearly defined. Not only does Vannak not know what is expected of him, but even the L10n-drivers did not assume defined roles which lead to a lot of very disorganized communication and contradicting advice, leading all to converge upon Vannak to help him out in a very confusing manner. 
    - Covered in this new Process do. Also working with Arky and Milos to better define roles for specific tasks/milestones, which can then be measured and tracked to assess a new locale's status & progress.

- Other locales were slow to respond when help was requested (or didn't respond at all). New-locales group was only used when Axel asked them to use it. Maybe we need to evaluate its effectiveness.
    - New locales group is pointed to repeatedly throughout this Process doc.

Comment 3

[Jeff Beatty [:gueroJeff]]

Adding https://wiki.mozilla.org/L10n:Managing_Assets to Process doc nav path. Currently being drafted and will be ready for review by the end of this week. 

Also added information about the option to release as a language pack, removed references to User Experience review, looked for and edited some of the too flowery language, removed links to l10n-drivers mailing list, fixed breaks in the first page's blocks, and ensured that there was a clear path to the Quick Start guide to answer the "where do I go from here" question.

Comment 4

[Jeff Beatty [:gueroJeff]]

Finished first draft of L10n:Managing_Assets. Added paragraph to https://wiki.mozilla.org/L10n:Localizing_a_project#Localizing_Firefox about creating and using L10n assets, linking back to the L10n:Managing_Assets page. Will request review tomorrow.

Comment 5

[Jeff Beatty [:gueroJeff]]

Closing bug. Any future revisions can be done outside of this.