Skip to content

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

License

etiennemarais/go-openapi-swag-demo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

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

Topics

Resources

License

Stars

Watchers

Forks

Languages