nushell.github.io icon indicating copy to clipboard operation
nushell.github.io copied to clipboard

Please enhance the documentation for people using a CLI web browser, without JavaScript.

Open DidierSpaier opened this issue 2 years ago • 2 comments

Related problem

Hello, I maintain the Slint distribution https://slint.fr which is accessible to the blind.

Many blind users prefer to use the command line than a graphical environment and a use a CLI web browser like links, lynx or w3m that has no support for JavaScript. I have packaged nushell recently and folks using one of these browser find tedious to read the documentation, like books, commands or cookbook (you may want to try yourself) as they have to scroll down a lot before getting to the content.

Describe the solution you'd like

Have a version with just the content and a few links on top of it (like to go one or two levels up in the tree).

Describe alternatives you've considered

Provide a link on top of each page "skip to content".

Additional context and details

No response

DidierSpaier avatar Mar 27 '23 17:03 DidierSpaier

We'd probably accept a PR for something like this in our docs repo. I'm not sure how it would work exactly but it would somehow need to be generated from our existing web pages.

fdncred avatar Mar 27 '23 19:03 fdncred

Would wrapping the content in <article> help?

ysthakur avatar Aug 04 '23 13:08 ysthakur