docs-community
docs-community copied to clipboard
Move language selection to a dedicated page?
I have been browsing various documentation sites, as part of exploration for #1, and I quite like how React has handled their presentation for the documentation translations: https://reactjs.org/languages
By having a separate page, the page can now contain:
- Clear indicators for the "state" / "completeness" of the translation efforts, like "In Progress" and "Needs Contributors".
- Clear links to contribute to each of the language-specific translation efforts.
- Callout to a documentation page, for folks interested in contributing additional languages.
- A lot more space to present translations across many languages. :)
I think all of these are basically non-feasible for a dropdown-based language selector like we have today on docs.python.org.
x-ref #4, since this would obsolete that.
A vote in favour of the language page.
I think there should be some quick link to the language chooser visible on every page though, perhaps with the globe symbol or suchlike.
A
I think there should be some quick link to the language chooser visible on every page though, perhaps with the globe symbol or suchlike.
Agreed. :)
Would a dedicated language page mean we lose the ability to jump from one translated page to another?
For example, if I'm on https://docs.python.org/3/library/exceptions.html I can select Spanish from the dropdown and am taken to https://docs.python.org/es/3/library/exceptions.html
There's great utility in this. If you end up on an English page via Google search or other article page, you can hop to your own language.
Similarly, if a translated page is not up-to-date you can hop back to the source English page.
... and I quite like how React has handled their presentation for the documentation translations: https://reactjs.org/languages
This site has been archived. The new one is https://react.dev/ and it does have translations (https://translations.react.dev/, for example: https://es.react.dev/), but curiously I don't see a languages page or any other links from the English site.