Whether the input is Go code and the output is Swagger Spec Or whether the input is Swagger Spec and the output is Go Code API documentation should be locked with the API implementation so that the documentation never goes stale.