アノテーションからドキュメントを作れるswaggerの使い方 - gong023の日記
swagger の概要と、基本的な使い方をサンプルを交えて書く。 なお、終始 PHP なので気をつけて下さい。 swagger の概要 開発ドキュメントをどうやって書くかという話題は常々ある。そして一番素直なアプローチを取ると、大抵 wiki みたいなアプリケーションを用意して、そこにドキュメント書こうぜという話になる。しかし、この管理は割とすぐ破綻してしまう。 理由はいろいろあるが、最新のコードに追従できなくなるとか、統一されたフォーマットを保証できず書き手によっては何を書いているのか全くわからないとかそういうケースが多い。 前者について、 swagger はアノテーションでドキュメントを書けるので違いは起きづらくなる。（ それでも不足だが自分でライブラリ作って補った ） また後者に関していえば、swagger は API の仕様を記述するためのフォーマットを提供してくれる。 つまり、s
コーディング規約をまとめてみた (Rails編) - bojovs::blog
半年ほど前に書いた「コーディング規約をまとめてみた (Ruby編)」に引き続き、Railsのコーディング規約もまとめてみました。前回と同じように、できるだけ理由を併記するよう努めました (主観的なものも含まれていますが…)。 気に入らない規約や、この記事に書かれている規約以外にも気をつけていることなどありましたら、コメントなどで教えてもらえると嬉しいです (理由も合わせて書いてくれると助かります)。 Railsのコーディング規約は以下のページを参考にまとめています。 http://guides.rubyonrails.org/contributingtorubyonrails.html#follow-the-coding-conventions https://github.com/bbatsov/rails-style-guide 前提 コード例は「コーディング規約をまとめてみた (Ru
Ubuntuに開発環境をインストール - imHo
届いたその日にOSをぶち壊してしまったので、OSを再インストールするため注文したUSB-DVDドライブが今日届いた。apt-getを使ってあれこれ開発環境をインストールする。 GCCのインストール $ sudo apt-get install gcc build-essential Emacsのインストール $ sudo apt-get install emacs GHCのインストール $ sudo apt-get install ghc6 http://www.gabuchan.net/blog/archives/32によれば手動インストールしたほうがよいようだけど、入るバージョンを調べたら6.8.2だったのとWindows版の6.10.1 でOpenGLが使えなかったので6.8.2でいいや、とapt-get。 GLUT mousehouse - Weblog: Ubuntuで（とりあえ
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
