概要 goa は swagger ドキュメントを生成してくれるので,これを swagger-ui をつかってサービスしてやると API が分かりやすく,お試しも出来てかなりいいかんじになります.しかし,環境によってはサービスを立ち上げることが出来ないとか,ドキュメントを確認して欲しい人がサービスにアクセスできないとかいうことが結構あります.そんなとき swagger.(json|yaml) をそのまま渡して 「swagger editor でみてね!」が通じない場合の対処方法です. ブラウザで見れるように加工する bootprint を使う swagger.json を変換してブラウザで見れるように変換したものを用意します.利用するのは bootprint と bootprint-swagger です. これは npm で最初に一回インストールしておけばいいです. Makefile に入れ
![goa tips: swagger-ui がサービスできないときのドキュメントどうする問題 - 押してダメならふて寝しろ](https://cdn-ak-scissors.b.st-hatena.com/image/square/2e7c03203b2a0d26bc353017fcc8f77b401ec626/height=288;version=1;width=512/https%3A%2F%2Fcdn-ak.f.st-hatena.com%2Fimages%2Ffotolife%2Fi%2Fikawaha%2F20161024%2F20161024154332.png)