2015年の技術本執筆環境 - Shin x Blog
2015年は「Laravelエンジニア養成読本」「Laravelリファレンス」、そしてまだ未発表ですが、もう一冊の技術本の執筆に参加しました。 時代によって技術本の執筆環境も変化してきています。今年、技術本の執筆に利用したツール、サービスを紹介します。 過去の技術本執筆環境は、以下のエントリにあります。 いまどきの技術本執筆環境 – 「CakePHP2実践入門」 このエントリは、Laravelリファレンス Advent Calendar 2015 の21日目です。 ツール、サービス 執筆に利用したツール、サービスは以下です。下記では、今年導入したツールについて書いてみます。 執筆: Vim + PhpStorm / Marked 2 原稿管理: GitHub（private repository） 連絡: GitHub Issue / ChatWork CI: レビューファイル自動生成 校
APIドキュメントを書くのが楽になるツールまとめ - Qiita
さいきんREST APIのドキュメントを書いていて、wiki使うのだるいし他に良い方法ないかな〜と調べてた時に見つけたツール群をまとめてみます。 追記: こちらも便利そうなので参考にどうぞ。 REST APIドキュメント作成ツールはapiary.ioが決定版かもしれない - Qiita swagger Swagger: A simple, open standard for describing REST APIs with JSON | Reverb for Developers デモ: Swagger UI ソースコード中にAPIの概要を書いておくと、それを元にドキュメントを自動生成してくれる。wikiやmarkdownで書くのと決定的な違いは、↓のようにドキュメント上のformからAPIコールを試すことができる点。 様々な言語のWAFに対応したライブラリも開発されてる。 Home ·
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
sakedrink.info
