search

apigear-io / cli

The ApiGear client as go project
https://apigear.io
MIT License
1 stars 2 forks source link

optional-versions #137

Open jryannel opened 6 months ago

jryannel commented 6 months ago

We shall remove all version informations at it is not used and just confuses people. Versioning is happening in version control systems.

name: tb.enum
version: "1.0.0"

Will become

name: tb.enum

Then we need to create a rule-set for non-breaking changes in API definitions and allow to express version changes using module identifiers. See also https://learn.microsoft.com/en-us/aspnet/core/grpc/versioning?view=aspnetcore-8.0#version-number-services

A new version would become 

name: tb.enum.v1
jryannel commented 5 months ago

version shall be optional, if missing version 1.0 shall be assumed