1519334 - Document "how to do localization" in DevTools

Status: NEW

(DevTools :: Documentation, enhancement, P3)

Description

[Ola Gasidlo [:ogasidlo] [:ola] OOO - please ping :ladybenko:]

In a discussion we had in a review for about:debugging-new, we decided it would be great to have some documentation for the devtools localization and best practice.

@jdescottes wrote:

[...]
For instance how to setup fluent with our vendored library, mention the shared
 l10n.js for non fluent projects, mention that we already cache simple calls to
 getStr... Probably also the bit about avoiding to concatenate ids.

Localization is complicated, so I would like to keep it short and forward to
 existing resources maintained by Localization team:

    https://mozilla-l10n.github.io/localizer-documentation/#how-to-contribute
    https://projectfluent.org/fluent/guide/selectors.html
[...]

Comment 1

[Julian Descottes [:jdescottes]]

Localization documentation should stress that variants should not be abused and should point to https://github.com/projectfluent/fluent/wiki/Good-Practices-for-Developers#prefer-separate-messages-over-variants-for-ui-logic