alt Hacker NewsBut unrelated but the manpages for kubectl were kind of weird, mostly linking to their online docs.
Is that a normal thing? I open the man tool for a reason, and it's to not read online docs
Replies
kwk1 • today at 6:13 PM
I've seen it elsewhere, but it's definitely annoying. For example KDE's build assistant tool:
$ kde-builder --help
...
Supported command-line parameters: https://kde-builder.kde.org/en/cmdline/supported-cmdline-params.html
... dewey • today at 3:51 PM
I’d argue that people using the man pages are a very small group compared to people using online documentation and all the familiar UX that comes with it.
Makes sense to me to keep one place updated and link to that one.
I've never used kubectl, but I just came across https://github.com/andykuszyk/noman.el which is an Emacs interface for browsing the `--help` output of commands:
> I primarily wrote this package to navigate the command line help from kubectl and aws, both of which have nested sub-commands, and quite verbose (and helpful!) command line help.
> Neither of these programs ships with man pages, or similar offline documentation. I find myself consulting the command line help often, but struggling to find the experience very ergonomic.