Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Move language selection to a dedicated page? #14

Open
pradyunsg opened this issue Nov 26, 2021 · 4 comments
Open

Move language selection to a dedicated page? #14

pradyunsg opened this issue Nov 26, 2021 · 4 comments

Comments

@pradyunsg
Copy link
Member

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
Copy link
Member Author

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

@AA-Turner
Copy link
Member

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

@pradyunsg
Copy link
Member Author

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

@hugovk
Copy link
Member

hugovk commented Feb 21, 2024

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants