Clover Kicker (probably not his real name) has written an amusing article on Kuro5hin.com (“technology and culture, from the trenches”). Although officially a guide for writing “bad documentation,” it’s really a guide about what differentiates good documentation from bad documentation.
Probably the most important lessons here is that more documentation isn’t necessarily better documentation, and the more documentation you have, the harder it is to maintain.
Of course, the lessons here are true of any document that needs to be kept up-to-date over time.
Here’s how a Twitter engineer says it will break in the coming weeks
One insider says the company’s current staffing isn’t able to sustain the platform.
Technology that lets us “speak” to our dead relatives has arrived. Are we ready?
Digital clones of the people we love could forever change how we grieve.
How to befriend a crow
I watched a bunch of crows on TikTok and now I'm trying to connect with some local birds.
Starlink signals can be reverse-engineered to work like GPS—whether SpaceX likes it or not
Elon said no thanks to using his mega-constellation for navigation. Researchers went ahead anyway.
Get the latest updates from
MIT Technology Review
Discover special offers, top stories, upcoming events, and more.