Hacker News new | ask | show | jobs
by ChrisMarshallNY 1603 days ago
Documentation, in general, is God-awful.

I mean, we live in an age, where, if Medium says that something is >7min read, no one reads stuff, and everyone uses videos to give, and consume, information.

I wrote a fairly ambitious infrastructure system, and spent months writing detailed, accurate, relevant, documentation.

That no one ever read.

It wasn't until I transferred the system over to a new team, who started posting videos on Facebook, that it started to take off. It's now the de facto world standard. Documentation is important, but so is the medium.

Sheesh. Kids, these days (Get off mah lawn!).

I write about how I do documentation, here (I need to update for DocC): https://littlegreenviper.com/miscellany/leaving-a-legacy/

It's definitely a >7min read.