プログラマのためのドキュメントと言えば、JavaDocやRDoc、PHPDocなどが有名だ。これらはソース上にコメントとして書けるので、実際のコーディングとドキュメントとが乖離するのを防ぐことができる。 0
RDocを閲覧できる
0
だがそれらのドキュメントをいちいち生成していたのでは面倒だ。編集の手間も軽減するこれを使ってみよう。
今回紹介するオープンソース・ソフトウェアはDocBox、RDocコラボレーションソフトウェアだ。
DocBoxはRDocをまるでWikiのように扱うことができるソフトウェアだ。ソースコードをDocBoxにインポートして動作する。ドキュメントはWikiのようにWebベースで編集が可能だ。 0
Web上で編集できる
0
編集した内容は元のソースコードへの反映したり、Gitリポジトリのドキュメントブランチへのコミットができるとのこと。*.rbファイルや、READMEファイルが対象になるので、定期的にインポートしていけば便利なドキュメントビューワーになるはずだ。 0
開発用ドキュメントが整備されない理由の第一は、閲覧したり利用したりする回数が少ないことが挙げられる。DocBoxを使えばWebベースで閲覧、コラボレートするようになって利用度が上がるはずだ。 0
iownbey's docbox at master — GitHub
http://github.com/iownbey/docbox/tree/master
0
MOONGIFTの関連記事
このエントリーを含むTwitter
アンケート