はじめに 本記事はコネヒト Advent Calendar 2017の21日目のエントリーになります。 こんにちは!本日は @itosho のターンです。2回目の登場でございます。本当はアイドルか野球の話をしたいのですが、今日はAPIドキュメントの話をさせていただきます。 TL;DR コネヒトではAPIドキュメントをGithubで管理してる! でも場合によってはAPIDOCが便利そう! 試してみた!よさげ! https://github.com/itosho/fake-idol-api 目的に応じてツールを選んでいこう! コネヒトでのAPIドキュメントの運用方法 現在、コネヒトではAPIドキュメントをGithubで管理しています。 具体的にはAPI Docs用のリポジトリを作成し… MarkdownでAPIの仕様を定義 それをPull Request形式で仕様レビュー 一定数のLGTMをも
