No problems with ideology when it’s right. Bundling documentation with the tool in a standard text format is the way to go. This can easily be reformatted for online wikis, manuals, etc.
Agreed. And I've been accused of it before (here, by dang).
But my point was that the gnu ideology was pushing contributors to use info pages (which many of us (myself included) tend to not use.
So perhaps the ideology should be reexamined from time to time. In this case, it should be: how do we make sure documentation is of highest quality and availability to our users (I'm more than happy to be challenged on that).
In that case, it might be worth considering making man pages a first class citizen again, along with html, as those are the natural destinations a user turns to when looking for help.
Personally I never use either. If I want to know how to do something, my first instinct is to Google it or use ChatGPT. The information is a lot more easily compressed and searchable in a web browser than in CLI tools
If you know how to use info, it’s faster to find what you’re looking for than to use Google or ChatGPT. The interface is incredibly snappy and lets you do a full text search across the entire manual you are reading, quickly and without leaving the keyboard.
Not that there’s anything wrong with using Google or ChatGPT to find what you are looking for, but info is a fast way to get authoritative information, and the documentation is also mirrored on the web so it can be easily indexed by search engines and LLMs.
Assuming you always have convenient access to the internet. And that you version of the tool you are working with matches whatever result you find online.
And even then, often the best results you get from google come from the man or info page anyway.
My first search when googling documentation for a tool is often "man <toolname<"
I like to minimize the amount of time I spent with instant access to the web because too much instant access to the web is bad for my mental health. That's why I arranged things so that I don't need web access when I'm programming, and Info is a major part of my having been able to do that.
pstuart|2 years ago
But my point was that the gnu ideology was pushing contributors to use info pages (which many of us (myself included) tend to not use.
So perhaps the ideology should be reexamined from time to time. In this case, it should be: how do we make sure documentation is of highest quality and availability to our users (I'm more than happy to be challenged on that).
In that case, it might be worth considering making man pages a first class citizen again, along with html, as those are the natural destinations a user turns to when looking for help.
shortrounddev2|2 years ago
klodolph|2 years ago
Not that there’s anything wrong with using Google or ChatGPT to find what you are looking for, but info is a fast way to get authoritative information, and the documentation is also mirrored on the web so it can be easily indexed by search engines and LLMs.
ericjmorey|2 years ago
gizmo686|2 years ago
And even then, often the best results you get from google come from the man or info page anyway.
My first search when googling documentation for a tool is often "man <toolname<"
hollerith|2 years ago
steve1977|2 years ago