alexjomin / openapi-parser

Simple and still naive openapi documentation generator from comments of your Go code.
18 stars 8 forks source link

Project versioning and releases #6

Open denouche opened 6 years ago

rlespinasse commented 5 years ago

Why not use manual versioning and use https://keepachangelog.com/en/1.0.0/ for the changelog? Also, the master branch can be rename v0, or v1 instead 😄

denouche commented 5 years ago

About branches or tags, with https://gopkg.in the major branch versioning is handled smoothly. GitHub.com/alexjomin/openapi-parser.v1 point to the branch v1 of the repo.

denouche commented 5 years ago

Oups. About keepachangelog, it is a manually maintained Changelog ?

rlespinasse commented 5 years ago

Yes, I use it on my personal project. Each PR came with an addition on this changelog under the Unreleased section. When I want to create a new version, I rewrite this section to be the new version and create an empty Unreleased section