ditzのreadmeを読む(前半)

正直言って、helpだけではよくわからないので、google先生にお願いしてREADME.txtを翻訳してもらう。 おかしな所はほんのり修正。

まずは前半部分だけ。

ditz

by William Morgan <wmorgan-ditz at the masanjin dot nets>

http://ditz.rubyforge.org

説明

Ditzはシンプルで軽量な分散型バグトラッカーです。 git, darcs, Mercurial, Bazaarのような分散型バージョン管理システムで動作するように設計されています。

また、SVNのような集中型システムで使用することができます。

DitzはYAML形式のファイルを使用して、ディスク上に問題データベースディレクトリを維持/作成します。 このディレクトリは、プロジェクトのソースコードと一緒にバージョン管理下におく事が出来ます。

Ditzは問題データベースファイルを作成/更新するためのシンプルなコマンドラインベースのインターフェイスを持っています。 また、ブラウザで現状を確認出来るように、静的HTMLの生成機能を持っています。(デモはDitzページを参照してください)

Ditzにはモデルフィールドにコマンドを追加し、出力を変更する堅牢なプラグインシステムが含まれています。 バンドルされているプラグインのマニュアルについてはPLUGINS.txtを参照してください。

現状ではDitzは、集中型システム用のバグ申請を行う方法を持っていません。

使い方

Ditzを使用するには、いくつかの異なる方法があります。

  1. ソースコードと同じ場所に問題データベースを設置する。issueはコミットの一部として含まれています。他の開発者からの変更による競合は、通常の方法で解決しマージします。
  2. ソースコードとは別のブランチに問題データベースを設置する。issueの更新をVCSによって管理することができますが、コードに直接結びつけられてはいません。
  3. VCSで問題データベースを管理しない。

これらのオプションはすべてサポートされています。どの方法を選択するかは、あなたのワークフローに依存します。

  • オプション#1
    おそらく非同期分散開発に最も適しています。個々の開発者が面倒を最小限に抑えて問題の状態を変更することができます。
  • オプション#2
    issueの追加/更新とコードの変更は、それぞれ独立してVCSにコミット出来ます。同期開発に最も適しています。(git同期プラグインを参照してください)
  • オプション#3
    集中型Webインターフェイスと同様に、いくつかの他の配布方式でのみ有用です。

コマンドライン要約

プロジェクトをセットアップして、bugs.yamlファイルを作る

  1. ditz init
  2. ditz add-release

issueの追加

  1. ditz add

現状確認

  1. ditz status
  2. ditz todo (or simply “ditz”)

お仕事をする

  1. コードを書く
  2. ditz close <issue-id>
  3. コミットする
  4. 3に戻る

ひと仕事終ったら

  1. ditz release <release-name>