I’ve spent some 5 hours just today documenting and writing instructions on some IT tools for my collective. One person said its cool though, so not bad.
The ability to write clear documentation is an invaluable skill. So many open source projects have terrible docs. The docs are probably written by the devs themselves, who perhaps don’t realize that end users won’t have the intimate knowledge of the thing they’re documenting as they do, so they leave a lot unsaid that should really be explicit.
In IT, at least in networking, systems quickly become black boxes even to the person that designed it, and good docs are just as useful to the person writing them.
I’ve spent some 5 hours just today documenting and writing instructions on some IT tools for my collective. One person said its cool though, so not bad.
The ability to write clear documentation is an invaluable skill. So many open source projects have terrible docs. The docs are probably written by the devs themselves, who perhaps don’t realize that end users won’t have the intimate knowledge of the thing they’re documenting as they do, so they leave a lot unsaid that should really be explicit.
In IT, at least in networking, systems quickly become black boxes even to the person that designed it, and good docs are just as useful to the person writing them.
You sir are a champion. So few of us do documentation and wonder why we have to fix the same problems over and over.
You deserve a smooch 😘
unsolicited comradery
Hey, u wanna share some means of reproduction?