For golang based HTTP/REST API documentation,I choose swagger. go-swagger has several features for swagger documentation. The go-swagger can generate swagger spec based code generation but I already have an REST API server. I use go-swagger with golang comment annotation for swagger spec generation.
For REST API development, Design first with writing spec and then generating codes from it is a good approach. goa is a famous tool for this style.
One of pleasures about coding is using good tools. Recently I use bumpversion, govvv and drone for version releasing.
bumpversion is automation for semantic versioning. Most of my projects have simple config file like below. (.bumpversion.cfg)
[bumpversion]
commit = True
tag = True
current_version = 0.8.4
parse = (?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)
serialize =
{major}.{minor}.{patch}
[bumpversion:file:VERSION]
Before release,I just run like below: