People Don't Read Docs

Through the years, I’ve learned many things, and one of them is that people don’t read documentation. And even when they do, there can always be misunderstandings. But today I want to focus on one specific part of documentation that people don’t read: changelogs, news, upgrade notices, all of those little things you should pay attention to when updating software. Just like anyone else, I’m definitely guilty of this too. I don’t read all the changelogs of all the tools I update. There’s just so much text nowadays, so many fixes, so many features. I always try – and that’s where the catch is – to read the breaking changes, though, especially for things I rely on daily. Why am I talking about this today? I’ve thought about it more than usual after having to plan some releases around migrations at work. It made me think of something from when I worked on IPFS, years ago, that has stuck with me. The Comment In 2023, I opened a PR to delete the writable gateway. It doesn’t matter what that…

Commenting on Bubbles has been removed. Why? If you want to talk about this post, write to the author, use the comments on their blog if it has them, or reply with a "RE:" post on your own blog. Suggestions? feedback@bubbles.town