bad floss opinion
documentation is absolutely undervalued and unappreciated by *nix users.
they love feeling like wizards who know all the arcana.
why else would they flock to a system as horribly documented at Linux?
if i want to know how something works, i read a Solaris or BSD man page.
if i want to feel stupid i can read a Linux man page. if i want to feel utterly frustrated i could try to read the GNU info page.
if i want to feel hopeless, i can read a venture capital funded corporate open source tool's documentation website.
bad floss opinion
@meena this is kinda humblebrag but my dotfiles have much better documentation than most FOSS projects out there and that should mean something.
like I wrote all this code myself for myself, it's mostly very simple stuff, but without comments and without documentation I myself would forget 90% of it, let alone others.
bad floss opinion
@meena I just c&p from some 8 year old blog post like a champ and hope that particular tool is still en vogue 
I usually get away with it because we are a CentOS shop, so that blog post is basically bleeding edge 
re: bad floss opinion
bad floss opinion
PREACH!
re: bad floss opinion
@bill i do!
but the only people who listen already know!
bad floss opinion
@meena I can quote every single word of the C and C++ ABI docs on Linux:
That's it. Can't do that on OpenBSD or Windows though, too many words
bad floss opinion
@meena really out of my depth here, guess I just wanted to say that with the CW, I thought this post would be about how toothpicks are better or something
bad floss opinion
@vultureculture thanks
i… i should actually floss my teeth.
bad floss opinion
@meena 9/10 dentists would approve of this message
bad floss opinion
bad floss opinion
@meena 💯
I still use the FreeBSD handbook and OpemBSD man pages even though I now work at a Linux shop.
`man x` just doesn't cut the mustard. Even worse is how often `apropos` fails to find anything helpful 😭
re: bad floss opinion
@meena GNU Info makes me grateful for No Starch Press and the authors that press on to actually write god-damned documentation and not some bizarro dump of the includes file.