APIドキュメントというか定義はAPI Blueprintで書き、aglioならびにgulp-aglioを使ってhtml化をすると楽だよ的なお話

まんまタイトル通り。
API定義は人によって色々と書き方もあるだろうし、なんならAPIクライアントを使ってそこで管理するとかそういう方法もある。
特にAPIクライアントはPawみたいな便利なものもあるわけで。
ただ便利だからこそ有料だったり、チーム間で共有するにはさらにお金が必要だったり。
そうなるとかなり面倒だし、どちらかというとリファレンスだけ管理できればいいんだけどっていうケースは意外と多い。

ということで今日はある意味省エネな感じでAPIの定義をしてリファレンスを作ろう的なお話をば。