yuisekiのブックマーク - はてなブックマーク

REST APIドキュメント作成ツールはapiary.ioが決定版かもしれない - Qiita
背景 APIドキュメントを書くのが楽になるツールまとめ - Qiita iodocsで便利なREST APIドキュメントを作成する - Qiita これまでずっとREST APIドキュメントをwiki上で管理していて、重たいページ上で特殊記法使ったり、スタイルの調整に時間を取られるのが辛かった。そこで良さげなドキュメントツールを色々調べてたんだけど、最終的にapiary.ioが一番良さそうという結論になってきた。このサービスの主な特徴。 markdown記法でAPIドキュメントを記述できるドキュメントの生成と同時にAPIのモックサーバを用意してくれるサインアップから5分くらいあればドキュメント公開できる。ドキュメントのホスト先を気にしなくてもいい。特にドキュメントと一緒にモックを作ってくれるのは他にはないポイントでかなり便利。使ってみるサインアップはGithubアカウントで h
yuiseki 2014/11/20
リンク
Eclipse中心の開発現場でIntelliJをキメてしまった時にやる設定 - Qiita
Eclipseユーザ中心の現場でIntelliJを使うと、微妙な挙動の違いでVCS上のファイル差分が無駄に出てうざい時がある。 Eclipseで書いたコードと合わせるため、最初に自分が設定した内容をまとめた。 Eclipseのフォーマッタを読み込めるようにする JetBrains Plugin Repository :: Eclipse Code Formatter プラグインを使ってEclipseと共通のフォーマッタを使えるようにする。 importまわりの設定 IntelliJのpackage importは先頭文字のアルファベット順で整列される。しかしEclipseではアルファベット順で並べる設定方法がないので、[Code Style] -> [Java] -> [Imports]タブでpackageの並び順や空白行のルールを地道に定義していく。 javadoc IntelliJでは
yuiseki 2014/09/11
リンク
iodocsで便利なREST APIドキュメントを作成する - Qiita
wikiとかでドキュメントを書くのが面倒で、良いツールを探していたらiodocsというnode製ツールを見つけた。これを使うとドキュメント作成が楽になるだけじゃなく、ドキュメント上のformからAPIリクエストを試せて便利っぽい。普段APIドキュメントを見つつcurlとかでリクエスト送信して試してたのが、全てドキュメント上で完結して良さげ。使い方 mashery/iodocsからcloneしてアプリを起動すると、FoursquareやLinkedin APIを叩くサンプルをすぐに試せる。redisが必要なのでserver起動を忘れずに。 ~/ $ git clone http://github.com/mashery/iodocs.git ~/iodocs $ npm install ~/iodocs $ redis-server & ~/iodocs $ npm start {
yuiseki 2014/06/11
リンク
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 ·
yuiseki 2014/06/11
tech

api
リンク
シェルスクリプトの実行・管理が楽になるRerunの紹介 - Qiita
普段使っているシェルスクリプトの数が増えてきて、うまく管理できるツール無いかなーと思っていたところにRerunというのを見つけたので紹介してみます。 Rerunって？ Rerun by rerun Rerun is a simple command runner that turns loose shell scripts into modular automation. rerunは複数のスクリプトをモジュールとして取りまとめ、スクリプトの管理と呼び出しをサポートしてくれるツールです。実際に導入しながらどんなものか見ていきます。インストール Installation · rerun/rerun Wiki を参考に。
yuiseki 2013/04/16
リンク
1