4 ms·
But look at it from the other side. Users that don't read your documentation and expect your software to work like they imagined are just a huge pain in the ass
by blueflow 4y ago
But look at it from the other side. Users that don't read your documentation and expect your software to work like they imagined are just a huge pain in the ass.
- mr_toad 4y agoGive a man a fish and he’ll assume he’s entitled to a lifetime supply of free fish.
- dataflow 4y agoThis has nothing to do with free vs. paid? The question is whether giving someone 99 of the same fish entitles them to expect the 100th one you throw in to be the same kind of fish, whether they paid for it or not.
- kkirsche 4y agoThis. You have to draw the line somewhere. Was this specific choice that line? Maybe not, but sometimes users aren’t right and changes just need to occur to ensure other asks from the same users can be delivered.
- vlovich123 4y agoFact of life: the vast majority of your users do not read your documentation (or do not do so carefully enough that what you put in your docs is an ironclad proof that all users adhere to). That's literally what Hyrum's law is about. Of course, you can choose to do whatever you want. It's valuable to recognize of course that you're trading off good will from your users with whatever technical improvement is getting made. Sometimes it's appropriate and inevitable (e.g. old behavior is just wrong or harmful and better to cut off). In the vast majority of cases though it's better to just have a better process in place to manage this with minimal disruption, identifying and communicating with broken users, and only then making that change.
- blueflow 4y agoThats support you could expect if you paid for it.
- vlovich123 4y agoLook. Even vcpkg broke which is a Microsoft product. I agree that there can be a continuum some times, but can we agree that this specific instance isn't anything like that? Even without vcpkg, the list of things impacted are anything that depends on Bazel, homebrew, conan, etc. The blast radius is quite wide regardless of documentation.
- deleted 4y ago[deleted]
- ilyt 4y agoAint nobody give a shit about you if you aren't bringing five or six figures as customer. Nobody is stopping rewrite that happened to break undocumented stuff you relied on if you $10/mo. This case is different as breakage probably affected github/microsoft themselves
- dataflow 4y agoI don't think expecting users to go look for a user manual on each website whose links they download from is a realistic expectation.
- ZephyrBlu 4y agoYou just described >90% of users. Everyone does this for something, most people do it for most things. You minimally read the docs, get something working and then leave it alone. Of course you're going to be pissed off when an implicit assumption which has been stable for a long time is broken.
- grepfru_it 4y ago>Of course you're going to be pissed off when an implicit assumption which has been stable for a long time is broken. This accurately describes my beef with golang
- missingdays 4y agoYes, but if you implement the checksum algorithm for GitHub archives, shouldn't you read the documentation about archives checksum?
- JonChesterfield 4y agoTurns out scripts contain download an archive from github and check against a hardcoded checksum copy&pasted into that script. All of those broke. None of the authors will have looked up exactly how github had calculated said checksum.
- lupire 4y agoIf you don't want users, feel free to ignore them.
- ilyt 4y agoI'd imagine they broke their own stuff doing it, considering npm broke on it
- throwawaylinux 4y agoIf your product supports some particular behavior, it will be used regardless of what you document. Microsoft was once renown for bug-compatibility so as not to break their users. The new wave of movers and breakers would forget that wisdom at their peril.
- KyeRussell 4y agoDo you work for Google?