Sphinx + Jenkins で始めるドキュメントの継続的インテグレーション | TECHSCORE BLOG | TECHSCORE BLOG
はじめに はじめまして、白川です。 システム開発では、多かれ少なかれドキュメントを作成する必要があると思います。 Word、Excelによって作成することが大体と思いますが、いろいろと問題点があるな、と感じるようになりました。 文書自体の整形（改行や改ページ、インデント、文字サイズ）が大変 仕様書が膨大になってくると、何がどこにあるかわからなくなり、内容のメンテナンス・維持が難しくなる 結果として、内容の陳腐化を招いてしまい、 ドキュメントと現実の仕様に差異が発生して、役に立たないドキュメントとなってしまいます。 そうなると、システムの仕様を把握するために、ソースコードをみないといけなくなりますし、 知見が担当者に依存してしまい、担当者が不在になると分からないことが多くなってしまいます。 それを防ぐために、 Python製のドキュメントビルダーであるSphinxを現在試しています。 Sph
Private Presentation
Private content!This content has been marked as private by the uploader.
Jenkinsでrspecで書いたテストのコードカバレッジを表示する - リア充爆発日記
前回の「さくらのVPS+Jenkins+github+rails3」の続き。 どうせ俺一人だから通知とかいいや、それよりカバレッジ見てー。という気持ちになったのでやってみた。 もう、普段からrspecでテストしていることが前提条件。 こちらを参考にした。っていうかほぼそのまんま。こっちのほうが絵とかついているからオススメ。 http://techracho.bpsinc.jp/yamasita-taisuke/2012_05_20/5560 まずローカルでできるようにする。 超簡単だった。 Gemfileに追加 group :test do ~snip~ gem 'simplecov' gem 'simplecov-rcov' end この２つを追加。bundle install。 spec/spec_helper.rbに追記 どたまのほうに require 'simplecov' req
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
