Provide a sample localization

[stasm]

Playdoh comes with the examples app which is localization-ready, but it takes a long series of unnecessarily complicated steps to actually see anything in any other language than English. This might be discouraging, and amplifies the feeling that l10n is something that happens somewhere else. I'd like to change it.

I suggest that Playdoh come by default with the locale directory, with a sample localization of the examples app. I chose to localize into French, since it's popular/easily recognized/similar to English enough to not look as if something just broke (Polish, anyone...?) :)

I made some changes to the docs to better reflect the l10n process that we've actually followed on a few past projects in Q1 and Q2.

Let me know what you think. Happy to discuss this further!

[fwenzel]

This looks very, very good. I am happy to include an example locale like you suggested. I agree L10n shouldn't look like it's not core to the project.

Can you git rebase -i this and squash some of these commits, so you end up with a shorter list? Tweaks and original commit do not need to be separate.

[stasm]

I squashed the commits into 4 big ones:

• actual changes to locale/ and bin/update_site.py
• changes to settings.py
• changes to the documentation
• tests.

[fwenzel]

Argh. Can you rebase it? This request can't be automatically merged anymore, probably because I messed with the docs. The docs themselves are now in the separate playdoh-docs repository (so that users don't fork the playdoh docs when starting off their project).

Sorry for the added work :(

[fwenzel]

Other than that, r+!

[stasm]

Argh. Can you rebase it? This request can't be automatically merged anymore, probably because I messed with the docs. The docs themselves are now in the separate playdoh-docs repository (so that users don't fork the playdoh docs when starting off their project).

Sure. Should I submit a new pull req to playdoh-docs with the updated l10n.rst file then?

Sorry for the added work :(

No problem at all!

[fwenzel]

Yes, a pull request to playdoh-docs works -- or you can land your code directly. Do you have push rights to the repo(s)?

[stasm]

I'll land in playdoh-docs once this request is merged, so that I can reference the merge commit.

[fwenzel]

Woot!

[stasm]

Woot indeed! :) Thanks Fred.

I landed the docs in mozilla/playdoh-docs/@256a89a