web-dev-qa-db-ja.com

要件にWikiを使用する

要件管理を改善する方法を検討しています。現在、Word文書をWebサイトで公開しています。残念ながら、(私の知る限り)あるリビジョンから次のリビジョンへの変更を確認することはできません。ウィキやVCSのように(または両方、ビットバケット上のウィキのように!)そうできることを強く望んでいます。

また、各ドキュメントには、開発者が特定の期限までに満たすことが期待される変更が記載されています。蓄積されたアプリ機能のコレクションはどこにも文書化されていないため、レガシーアプリをすばやく修正しようとすると、バグと(設計が不十分な)機能を区別するのが難しい場合があります。

だから私はフィードバックを得たいと思った。どうですか:

  1. 誰がいつ何を変更したかを追跡できるようにwikiを使用します(ほとんどの場合、最後に見たときから編集が行われたことを確認するためにif)。
  2. たとえば、締め切りごとに1つではなく、製品ごとに1つのwikiページを用意し、実装する必要のある変更ではなく、製品のすべての機能に対応します。このように、ページの特定のリビジョンを確認して、特定の時点でアプリが何をすべきかを確認できます。また、要件について前回のリリース以降のページへの変更を確認できます。次の期限までに実装されます。

ワダヤシンク?

9
jyoungdev

はい、それは良い解決策に聞こえます。ページを単純な構造で整理し、閲覧しやすい場合です。

シンプルな構文のWikiを選択してください。 ( Dokuwiki は単純なものであり、DBは必要ありません)

編集:バージョン管理システム、つまりSVNまたはBZRを使用している場合は、 Trac を試してください。ここで、マイルストーンを定義し、バグと機能のリクエストを維持し、独自のワークフローを定義してバグを管理します。ウィキが含まれています!

9
keatch

Wikiは良い方法です。ドキュメントがまだバージョン管理されていれば最高だと思います。最新の機能を維持するフローティングドキュメントを作成できます。それでもスナップショットを撮ると、誰かが3バージョン前にそのソフトウェアのドキュメントを簡単に見直すことができます。ドキュメントの履歴を確認する必要はありません。これは、迅速な復帰のために作成されており、数年または数か月前にさかのぼるにはあまり適していません。

私はMediaWikiを使い始めましたが、現在はXwikiを使用しています。かなり良いGUIエディターがあり、誰もトレーニングなしで使用できます。また、「スペース」というアイデアもあり、各スペースは新しい名前空間を作成するため、さまざまな製品はすべて、product_x_featuresなどの愚かなものではなく、「機能」と呼ばれるページを持つことができます。これにより、複数のWikiインストールを管理する必要性が大幅に減少します。また、Wordとxwikiを統合するツールがあり、Word文書を直接Wikiに保存できます。すべてがはるかに機能が豊富だと言った。

2
Quaternion

私はあなたのプロジェクトごとのwikiアプローチが好きです。あなたはbitbucketについて言及しましたが、リポジトリホストとしてそれらを使用していると思います。そうでない場合は、GitHubのWikiも確認します。

あなたが少しお金を費やすことをいとわないなら、チェックアウト 灯台 。現時点で機能のリクエストとバグを追跡するための私のお気に入りの方法です。また、Pivo​​tal Trackerを使用するのも大好きです。ピボットは無料でしたが、現在は有料モデルに移行しています。

1
Mark Turner