/go-openapi-swag-demo

A typical micro service that serves a JSON api to a set of clients somewhere. It uses Swag to generate the swagger/openapi compliant specs and then on main push will ship the generated file to the UI repo to get auto published for your team to have living documentation

Primary LanguageGoMIT LicenseMIT

go-openapi-swag-demo

Api Docs

Summary

Trying to write documentation by hand is a tedious ask. This optimizes writing documentation for the writer as close to the code as possible by using annotations to auto generate api docs.

Ths issue with most outputs are that it would just live in a file somewhere and that sucks. By leveraging github actions and a little magic, we can send the generated file to a repo that auto builds and deploys the documentation making it more up to date.