Skip to content

Move language selection to a dedicated page? #14

Description

@pradyunsg

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.

Activity

  1. pradyunsg commented on Feb 7, 2022

    @pradyunsg
    MemberAuthor

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

  2. AA-Turner commented on Feb 15, 2022

    @AA-Turner
    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

  3. pradyunsg commented on Mar 6, 2022

    @pradyunsg
    MemberAuthor

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

  4. hugovk commented on Feb 21, 2024

    @hugovk
    Member

    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.

  5. StanFromIreland commented on May 24, 2025

    @StanFromIreland
    Member

    I don't see why we shouldn't have both, it would be useful for linking to. A good use case would be python.org "Non-English documentation" section which currently links to the very outdated wiki.

    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.

    They still have this page, which is very nice IMO as it has contribution links!

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

Metadata

Metadata

Assignees

No one assigned

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions