- use markdown files in swagger - automate version, use swager.conf template - embed swagger ui index.html as docs.html