search

nvaccess / nvda

NVDA, the free and open source Screen Reader for Microsoft Windows
Other
2.08k stars 625 forks source link

Add language and release selectors to web hosted user documentation #17022

Open seanbudd opened 3 weeks ago

seanbudd commented 3 weeks ago

Is your feature request related to a problem? Please describe.

Each release post we link to the changes file hosted at: https://www.nvaccess.org/files/nvda/releases/2024.3/documentation/en/changes.html.

The user guide is also hosted at a similar URL https://www.nvaccess.org/files/nvda/releases/2024.3/documentation/en/userGuide.html.

We also host translated documentation, but the UX to reach it is quite obscure, e.g. through file browsing at:

https://www.nvaccess.org/files/nvda/releases/2024.3/documentation/

Describe the solution you'd like

It would be nice to have drop-down selectors to select language and release while browsing a user guide or changes doc.

Describe alternatives you've considered

Existing navigation e.g. https://www.nvaccess.org/files/nvda/releases/2024.3/documentation/

Additional context

dpy013 commented 3 weeks ago

We can do this by using hugo or the default VuePress theme. The only downside to VuePress is that you have to split the document into one, one sheet.

seanbudd commented 3 weeks ago

I don't think either of those are necessary, it can be added quite easily with plain HTML and JS to the HTML template for these docs