yuichi_katahira https://blog.hatena.ne.jp/yuichi_katahira/ 仙台 Ruby Vim JavaScript フリーランスプログラマ https://katahirado.hatenablog.com/ Rails Autodocとはなんぞやという方はこちらの記事を参照。 公式はこちら で、大変便利なAutodocだけど、注意点が２つ。 まず一点目はRspc3で動かない点。プルリクが上がってるが、取り込まれてない。 なので、forkして使ってる人が結構いる感じ。 ２点目、通信が発生しているところでマークダウンが生成されるので、shared_exampleとか使って、そこで実際の通信が発生するようなものは、ドキュメントが全てshared_exampleがあるファイル名で生成されてしまう。 具体的に言うと、例えばこちらの記事のようなヘルパーメソッドを用意して、これでAUTODOC=1でAPIのテストを全て行っ… 190 <iframe src="https://hatenablog-parts.com/embed?url=https%3A%2F%2Fkatahirado.hatenablog.com%2Fentry%2F2014%2F09%2F16%2F194756" title="RailsでつくるAPIサーバのドキュメントを自動生成してくれるAutodocを使っていて気をつけること - 仙台 Ruby Vim JavaScript フリーランスプログラマ" class="embed-card embed-blogcard" scrolling="no" frameborder="0" style="display: block; width: 100%; height: 190px; max-width: 500px; margin: 10px 0px;"></iframe> Hatena Blog https://hatena.blog 2014-09-16 19:47:56 rich https://katahirado.hatenablog.com/entry/2014/09/16/194756 1.0 100%