728068 - Document day-to-day maintainance flow in narro

Status: RESOLVED FIXED

(Mozilla Localizations Graveyard :: Documentation, defect)

Description

[Axel Hecht [:Pike]]

The current narro docs are focused on new contributors, and stop at the point where you register a localization effort.

We should have doc that explains how localizers can use narro to maintain their localization effort, export updates for commit, investigate that commit, and push it.

Also, if someone has contributions in hg, how to pull them in to narro, say if a file is moved.

Comment 1

[Jeff Beatty [:gueroJeff]]

(In reply to Axel Hecht [:Pike] from comment #0)
> The current narro docs are focused on new contributors, and stop at the
> point where you register a localization effort.
> 
> We should have doc that explains how localizers can use narro to maintain
> their localization effort, export updates for commit, investigate that
> commit, and push it.
> 
> Also, if someone has contributions in hg, how to pull them in to narro, say
> if a file is moved.

The tutorial moves through the process of maintaining a L10n effort. It outlines exporting language packs and references lang pack testing on another wiki page, as testing a lang pack (or even an exported zip file) lie outside of the scope of Narro, as well as pushing it (unless I'm mistaken).

I have already created another bug to take note of additional topics to outline in an intermediate or advanced Narro tutorial (https://bugzilla.mozilla.org/show_bug.cgi?id=718956) and another about hg topics to include in the MDN wiki (https://bugzilla.mozilla.org/show_bug.cgi?id=708410). Can we call this a duplicate and move these items to those bugs?

Comment 2

[Axel Hecht [:Pike]]

Reopening:

- bug 718956 lacks concrete topics to document, while this one has.
- the artifacts that come out of an export from narro are special to narro, and not applicable to localizing on mercurial in general, thus I don't see this as a dupe of bug 708410.
- bug 718956 also talks about admin features, which I don't think should be covered on the same front as this

Comment 3

[Jeff Beatty [:gueroJeff]]

(In reply to Axel Hecht [:Pike] from comment #2)
> Reopening:
> 
> - bug 718956 lacks concrete topics to document, while this one has.
> - the artifacts that come out of an export from narro are special to narro,
> and not applicable to localizing on mercurial in general, thus I don't see
> this as a dupe of bug 708410.
> - bug 718956 also talks about admin features, which I don't think should be
> covered on the same front as this

Sounds reasonable :-)

I'll look into this this week as I work on creating additional Narro documentation.

Perhaps this should be part of an Intermediate tutorial. I'd rather not add too many details to the basic tutorial but keep it targeted at brand new contributors. Opinions?

Comment 4

[Axel Hecht [:Pike]]

Yeah, separate page sounds totally fine.

Comment 5

[Jeff Beatty [:gueroJeff]]

Intermediate tutorial has been written and reviewed and taken out of draft. Closing bug.