こんにちは。エンジニアの原です。 突然ですが、仕様書の管理ってしんどいですよね。 ないと困るのはわかっていても、いざ作るとなるとどうも気が乗らない。 Excel や Word のなどを使って作ってしまうと、変更があったときに どこに変更があったのかわかりにくかったりします。 やっぱり履歴を持つようなファイルは Git 管理がしたいですよね。 というわけで、今回は「 Git 管理できる仕様書を作成しよう」をテーマに、 API Blueprint の紹介をしたいと思います。 API Blueprintとは API Blueprint とは Web API の仕様を表現するための言語のことです。 API Blueprint 公式ページ API の仕様を表現するための様々な文法を持っています。 書き方は Markdown と同じ形式ですので、書き方も馴染みのあるものです。何よりただのテキストファイ
![API Blueprint を使って Web API の仕様書を書こう](https://cdn-ak-scissors.b.st-hatena.com/image/square/4cd6bcd98c8e8a2a5ae1b2ffb7d8d168c9b80c31/height=288;version=1;width=512/https%3A%2F%2Fblog.fenrir-inc.com%2Fwp%2Fwp-content%2Fthemes%2Ffenrir_dev%2Fimg%2Fcommon%2Fogp_dev_engineer.png)