Put the doc language in the doc url

[brson]

As suggested in http://ericholscher.com/blog/2014/feb/27/how-i-judge-documentation-quality/, our doc URLs should be future-proofed for translation by putting 'en' somewhere in them. Nominating.

[steveklabnik]

This has pros and cons. If you use Accept-Language, then you end up showing the correct language to whomever you link.

It's not as simple as 'put it in the URL' if you want to do it right. After a bunch of thought, https://github.com/jcasimir/locale_setter#how-it-works is what I came up with on this topic.

[kud1ing]

This has pros and cons. If you use Accept-Language, then you end up showing the correct language to whomever you link.

This depends on the implementation. The user should be able to adjust that "correct language".

[steveklabnik]

Exactly. All I mean to say is that 'put the language in the URL' isn't a universal solution; there isn't one.

[brson]

@steveklabnik Which of the techniques you suggest can work with a static site?

[darnuria]

There is some work who have made for Support Mozilla and MDN.
Just a little JavaScript code.
I can ask some peoples who work on it.

[steveklabnik]

@brson depends on what you mean by 'static site.' The tiny bit of logic here should be able to be done in an nginx or apache config. Think mod_rewrite.

[pnkfelix]

cc our localization story in #12553

[pnkfelix]

Assigning 1.0, P-low. (Felix would like to be able to hack on his urls to jump between french/english and between versions.)