godotengine / godotengine/godot-docs

Add a banner allowing the user to redirect to a localized version

Open
#9,926 1 comment 1 reaction 0 assignees View on GitHub
content:website enhancement topic:i18n
Dominant language
reStructuredText
Stars
5.7k
Forks
3.8k
Avg merge
1d 20h
Merged PRs (30d)
25

Description

The language switcher on the bottom left is hardly discoverable for users not familiar with ReadTheDocs, as it's hidden by default.

I think it would benefit more users if we do some detection and provide the option to redirect to the user's preferred language on the docs page. For example, visiting might prompt you with a similar dialog if your browser's preferred language is not English.

I'm not sure if ReadTheDocs/Sphinx actually allows implementing this. But if it does, the logic might be something like this:

1. Check the `Accept-Language` header to see if we provide a version that matches the user's preferred language.
2. If such a version exists, show a banner (like the "Up to date" banner) that contains:
    * A message possibly in that language.
    * A link that redirects to the same page in that language.
    * A close button that prevents this banner from showing again, at least in this session.

See also https://github.com/godotengine/godot-proposals/issues/10538

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.