My 2c: I think we should start moving towards all canonical documentation being on the website. Go already started doing this with https://go.dev/ref/mod, for example. Then go help modules is a short summary with HTTP links, rather than dozens of pages printed out to the terminal, which overwhelm almost anyone.

I also feel like markdown-like styling is helpful. Headers, links, code blocks, and so on. That is technically possible on the terminal with something like man pages, but I think web pages are generally more accessible to the majority of users, particularly when there is so much information.

We could and should keep cue help, but its contents should be limited in size and complexity. Packagers or distros could always ship the HTML pages alongside cmd/cue so that all the docs are available offline.

Adjacent to this issue, https://alpha.cuelang.org/docs/reference/cli/ is now available.