Mastodawn

Mina Jun 14, 2022

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.

Show thread

go͚ktu͠g

@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.