News for hackers. Stuff that matters.
Re:How Shopify Manages API Versioning and Breaking Changes by Navarr on Thursday December 19, 2019 @09:22AM (#21835101)
I do not know any advantage of date-based versioning, other than someone knowing how new it is.

Semver is important for knowing whether or not to evaluate for breakages. You can theoretically combine both of these by making the date the patch version or supplying it as a version metadata

Re:How Shopify Manages API Versioning and Breaking Changes by Znafon on Thursday December 19, 2019 @09:33AM (#21835192)
> I do not know any advantage of date-based versioning

It can be very useful for continuous improvement and handling forward compatibility. Here's how Stripe do it:https://stripe.com/en-fr/blog/api-versioning, we found that very convenient.

Re:How Shopify Manages API Versioning and Breaking Changes by keithwhor on Thursday December 19, 2019 @09:37AM (#21835229)
I think it’s the implied stability, especially for long-standing APIs. S3’s API is 2006-03-01 — meaning there haven’t been breaking changes in over 13 years. This creates a psychological contract with developers that nothing’s changing anytime soon.

The trade off is that AWS has some godawful APIs (DynamoDB has the least intuitive API I have ever worked with). But they’re stable.

If you go with a date-based approach and create a process + contract whereby you guarantee API stability and / or deprecation date, the developer always knows exactly how much time they have before an upgrade.