Stable API release

Question

Stable API release

erdaltsksn opened this issue 4 years ago · comments

The version referenced in a go.mod is a pseudo-version based on the commit (v0.0.0-20200121091418-667557018717).

Pseudo-versions are a special type of pre-release version. Is it possible to release a stable API?

You can release v1.0.0 using git tags.

git tag v1.0.0
git push --tags

NOTE: In my projects, I prefer to use v0.1.0 as a initial version.

Reference: https://blog.golang.org/publishing-go-modules

Mikkel Oscar Lyderik Larsen · Answer 1 · Wed Jul 08 2020 19:36:58 GMT+0800 (China Standard Time)

@erdaltsksn This seems like a reasonable request. I would not release v1.0.0 though since we have several issues/use cases reported which may require changing the API a bit. So to set expectations correctly I would also choose something like v0.1.0 for now. @szuecs WDYT?

Sandor Szücs · Answer 2 · Fri Jul 10 2020 00:26:51 GMT+0800 (China Standard Time)

@mikkeloscar yes v0.1.0 sounds good

Mikkel Oscar Lyderik Larsen · Answer 3 · Fri Jul 10 2020 15:47:32 GMT+0800 (China Standard Time)

I have tagged the current master as v0.1.0