(2016/11/24追記) 少々アップデートしました。 (追記ここまで) 以前、API ドキュメンテーションツールを色々検討していて Apiary.io を使ってみたんですが その時一緒に調べて気になっていた aglio というツールも試してみたところ、 どうやら自分にはこちらの方が合ってる気がしたのでインストール方法などメモ。 参考にさせていただいた記事 使用するツールはすべて npm でインストール可能なものだが、環境構築については gulp を使う。 gulpfile.js についてはほとんどこちらのコピー。 API 設計ドキュメントをGitHubのプルリクでレビューしつつ Apiary みたいに使うには - Qiita 特に、md (markdown) ファイルを複数ファイルに分割して管理する方法は非常に参考になりました。 使うツール aglio HTML ドキュメント生成ツール