Aug. 27, 2023, 5 p.m.

Haunted manuals, or hauntology and bitrot

rinsemiddlebliss

Hi friends,

I always forget something. Like I forgot to send a newsletter when there was a new blog post for (checks watch) almost two months. Oops. Sorry about that.

To make it up to you, I give you a whole nifty series I've been working on for the last three weeks. Start here and keep going (there are 3 in the series so far):

Haunted manuals You've heard of the curse of knowledge, but could your manual be haunted as well?

Here's a little excerpt:

When I say some manuals are haunted, I'm not talking about an instance of a particular manual like the Diesel D318 that has been touched and used and marked up and perhaps even bled on. I am talking about the content of the manual. A GitHub README can be haunted. A Word document left behind by a former coworker on their last day can be haunted. An instructions tab in a spreadsheet can be haunted. (A spreadsheet can be haunted, but maybe that's another topic.)

It's an ongoing series and I've added a little navigational element at the bottom of each one. If you're the kind of person who waits until a whole book series is released before you read it, you might want to wait until this Friday, when I hope to wrap it up.

In the mantime, you could also check out another post I wrote since I last wrote (as it were), which seemed to resonate with the technical writing and knitting crowd. Maybe that's not exactly a crowd, but if you're in it, you'll probably like User stories for legible knitting patterns: Knitting patterns could be a lot more legible and enjoyable to use if they broke free of the constraints of print.

That's it for this catch-up episode. From now on, I'm going to try to send the newsletter at the same time as I merge the PR with the blog post. The cost of that is that I won't write as much of a cute intro and you'll see the typos before the next mornings fixit PRs. But I think that's better than not sending you a newsletter at all for months.

See you on the internet!

AK

You just read issue #12 of rinsemiddlebliss. You can also browse the full archives of this newsletter.

Share on Facebook Share via email Share on Mastodon Share on Bluesky
Bluesky https://sfba.social… Instagram
Powered by Buttondown, the easiest way to start and grow your newsletter.