docs-community icon indicating copy to clipboard operation
docs-community copied to clipboard

Move language selection to a dedicated page?

Open pradyunsg opened this issue 3 years ago • 4 comments

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.

pradyunsg avatar Nov 26 '21 03:11 pradyunsg

x-ref #4, since this would obsolete that.

pradyunsg avatar Feb 07 '22 21:02 pradyunsg

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

AA-Turner avatar Feb 15 '22 13:02 AA-Turner

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. :)

pradyunsg avatar Mar 06 '22 08:03 pradyunsg

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.

hugovk avatar Feb 21 '24 20:02 hugovk