Closed Bug 1599045 Opened 2 years ago Closed 2 years ago

Refactor and clean up localization-related documentation

Categories

(Core :: Internationalization: Localization, task)

task
Not set
normal

Tracking

()

RESOLVED FIXED
mozilla73
Tracking Status
firefox73 --- fixed

People

(Reporter: Pike, Assigned: Pike)

References

Details

Attachments

(4 files)

There's a couple of big-picture problems with our l10n-related documentation.

For one, we have top-level docs on l10n, but they're not talking about Fluent. We have Fluent-related docs, but they're not discoverable from the top-level l10n docs. The answer is to refactor those to become one.

Much of the Fluent docs are "this is new" and "we will soon". Some of which was done a year ago. The answer is to remove the change-language and pitches, and to make Fluent be the first things we document.

Some documents can use being split up, at least the migration doc.

And finally, the docs in intl, l10n, and build should cross-link to each other.

I'm filing this in Localization, as I'm not going to touch the actual Intl docs.

We'll be doing redirects at the final stage of this patch queue.

The "Localization" docs in tools/compare-locales are really mostly
build, so merging that content into the builds doc.

Removing Android parts, add Fluent there, noting DTD deprecation.

Moving the glossary to the actual l10n docs.

With proper top-level structure, show 2 levels of l10n and intl
on the front-matter page.

Depends on D55124

Depends on D55126

Pushed by axel@mozilla.com:
https://hg.mozilla.org/integration/autoland/rev/8ea8346e9edb
part 1 - untangle l10n from intl documentation, r=flod
https://hg.mozilla.org/integration/autoland/rev/a4cd8dfba3b6
part 2 - merge compare-locales docs into build docs, r=flod
https://hg.mozilla.org/integration/autoland/rev/c566f52a502b
part 3, Fluent is the status-quo, r=flod
https://hg.mozilla.org/integration/autoland/rev/513acd69e06c
part 4 - redirects from old to new locations, r=sylvestre

(In reply to Axel Hecht [:Pike] from comment #0)

Some documents can use being split up, at least the migration doc.

And finally, the docs in intl, l10n, and build should cross-link to each other.

These two need to be done in follow-ups.

See Also: → 1601249
Blocks: 1601321
You need to log in before you can comment on or make changes to this bug.