Semantic Versioning is a terrible mistake (opens in new tab)

(reprog.wordpress.com)

4 pointsMikeTaylor2y ago4 comments

4 comments

ahuth2y ago

I'm amenable to the idea of not making breaking changes if you can help it.

But...

> To say it another way: If you need to make a breaking change to your API, it means you screwed up. Don’t screw up.

I'm skeptical that we can always predict the future well enough to get an API perfect from the beginning.

Sometimes the best we can do is do the best we can, learn, and do better.

MikeTaylorOP2y ago

I did wonder how much to soften this message, because yes, of course, there really ARE times when a breaking change is necessary. But I think those account for maybe 1% of the major releases we see these days. The rest are down to laziness, carelessness, or just not having thought about it at all.

TillE2y ago

This is an extremely uncharitable way to characterize how our understanding of a problem, our requirements, etc evolve over time and with feedback from users.

Making a good API is really hard. I think there's plenty of room for discussion about how we should break things, but "just do it right the first time" is not realistic.

1 more reply

j / k navigate · click thread line to collapse