iktakahiro https://blog.hatena.ne.jp/iktakahiro/ Witch on the Other Shore https://iktakahiro.hatenablog.com/ tech REST API のドキュメンテーションはサービス開発における課題として認知されており、解決に向け近年さまざまな試みが行われています。OPEN API および Swagger はその有力な動きの1つです。 長いものには巻かれろ (?) ということで、今回は Swagger 定義ファイルをベースとした REST API ドキュメントの生成方法をまとめます。 結論 swagger2markup-cli と asciidoctor を組み合わせて HTML ファイルを生成するのがよさそうです。 課題の共有 Swggger 定義ファイルからドキュメントを生成する手順はいくつか存在します。 swagge… 190 <iframe src="https://hatenablog-parts.com/embed?url=https%3A%2F%2Fiktakahiro.hatenablog.com%2Fentry%2F2016%2F11%2F23%2F100000" title="Swagger 定義ファイルから そこそこいい感じの静的 REST API ドキュメント作成する - Witch on the Other Shore" class="embed-card embed-blogcard" scrolling="no" frameborder="0" style="display: block; width: 100%; height: 190px; max-width: 500px; margin: 10px 0px;"></iframe> https://cdn-ak.f.st-hatena.com/images/fotolife/i/iktakahiro/20161122/20161122200815.png Hatena Blog https://hatena.blog 2016-11-23 10:00:00 rich https://iktakahiro.hatenablog.com/entry/2016/11/23/100000 1.0 100%