4 ms·
I think what OP means is that having good documentation should not require you to read a blog of any sorts, even if it is linked in the man page. Either documen
by bosie 5y ago
I think what OP means is that having good documentation should not require you to read a blog of any sorts, even if it is linked in the man page. Either documentation is good OR you read the blog, you cannot have both.
- jcelerier 5y agoI disagree, for instance in a man page I don't want to read the rationale for something (which the blog provides), just the raw "if you do this, then that will happen". That would have its place in a GNU info book instead.
- zozbot234 5y agoPlenty of man pages have a dedicated RATIONALE section. You don't have to read it, but the stuff is documented.