API Versioning

Some thoughts on versioning the impl and developer workflow

• I am leaning to a Gitflow-like workflow:

  • https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow
  • https://datasift.github.io/gitflow/IntroducingGitFlow.html

• Perhaps we could use a happy medium between Gitflow and Feature Branching: https://www.atlassian.com/git/tutorials/comparing-workflows/feature-branch-workflow

• Some interesting arguments against simplification here:

https://softwareengineering.stackexchange.com/questions/336249/gitflow-branching-strategy-but-without-the-develop-branch

https://www.atlassian.com/git/tutorials/comparing-workflows

https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow

https://www.endoflineblog.com/oneflow-a-git-branching-model-and-workflow

https://www.endoflineblog.com/gitflow-considered-harmful

https://www.endoflineblog.com/follow-up-to-gitflow-considered-harmful