Follow

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.

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.

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 :flan_royal:

I usually get away with it because we are a CentOS shop, so that blog post is basically bleeding edge :flan_peek:

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 

@meena

If "Unix" = "Linux"

:brain8:

(Wizard Brain)

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 😭

bad floss opinion 

@meena @mwlucas if they’d document linux, it would be obvious, how much is so badly designed. If you’re into horror, compare how to atomically change firewall rules for pf and iptables. And then look how it’s actually done, in e.g OpenWRT.

Sign in to participate in the conversation
Cathode Church

A place for trans makers, coders, tinkerers and dreamers.