slatedocsを試してみた

 APIのドキュメントってどうしようか?
 という話の中で、メンバーからslateがいい感じらしいという推しがあり試してみました。

 とりあえず動きを確認するという事で、DockerHubにあったslateを手っ取り早くdocker pullして動かします。
 
 動きは確認出来たので、swagger-to-slateを使ってswaggerで作成してあったAPI仕様を変換し、作成されたmdファイルをindex.html.mdにリネームしてdocker-composeでボリューム指定します。

 各言語向けの説明は別途書き込む必要がありますが、いい感じで表示されています。

 index.html.md内のincludes部分にファイルを追加指定すれば、複数のファイルに分割する事が出来そう(初期インストールでは_errors.mdが配置されています)なので、index.html.md内はイントロや認証関連のみ記載し、includesで複数ファイル構成にするのがよさそうですね。