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

Flyout: more visible language selection #9957

Closed
jeanas opened this issue Jan 27, 2023 · 2 comments · Fixed by readthedocs/addons#64
Closed

Flyout: more visible language selection #9957

jeanas opened this issue Jan 27, 2023 · 2 comments · Fixed by readthedocs/addons#64
Labels
Design Design or UX/UI related Improvement Minor improvement to code Needed: design decision A core team decision is required

Comments

@jeanas
Copy link

jeanas commented Jan 27, 2023

Currently, the UX for switching to another language is to click on the "v: xxx" (like "v: latest") RTD badge, getting something like this:

image

In my humble opinion, language selection would ideally be far more discoverable.

  • You have to click on a button to discover it,
  • The button's title doesn't say what it's for. If you understand "v: latest", it's about the version of the documentation.
  • The languages are given as two-letter codes.

The problem here is that if you are browsing a page that is in a language you don't understand, you will quickly give up unless you can immediately notice that it has a translation available. So the current language selection is not discoverable enough.

For https://extending-lilypond.readthedocs.io, I added something in the header, it looks like this:

image

Not perfect, but already better in my opinion. I would like to record the feature request of something more discoverable like this. It could also be a dropdown, which would be more usual (but I didn't take the time to learn the CSS/JS for that).

This is also related to #7471: it would improve the UX for non-English speakers (well, people who don't speak the source language of the docs, but that's usually English) if the right language were chosen by default from the browser preferences, while still allowing selection.

Thank you for considering this and for making RTD the incredibly practical tool that it is.

Related: readthedocs/addons#250

@humitos humitos added Improvement Minor improvement to code Design Design or UX/UI related Needed: design decision A core team decision is required labels Jan 27, 2023
@humitos
Copy link
Member

humitos commented Jan 27, 2023

Thanks for sharing this feedback with us. It's really valuable 💯

@agjohnson this could be considered into all the Javascript refactor we are about to start doing

@humitos humitos changed the title Enhancement: more visible language selection Flyout: more visible language selection Jan 31, 2023
@humitos humitos added this to the I18n improvements milestone Feb 2, 2023
@humitos
Copy link
Member

humitos commented Sep 6, 2023

This would eventually be supported by readthedocs/addons#64

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Design Design or UX/UI related Improvement Minor improvement to code Needed: design decision A core team decision is required
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants