specifications - どのように共同で仕様を作成しますか?

Question

私は、地理的に分散した開発者の小さなチーム (他に 2 人) と協力しており、仕様について協力するための良い方法を探しています... Google ドキュメントを使用して仕様を作成することを考えています私たちは皆、中央の場所でそれを変更するためにアクセスできます。

あなたは何をした？どんな良いアイデアがありますか？

score 2 · Accepted Answer

IMHO、ワードプロセッサはプログラマーにとって間違ったツールです。仕様はプレーンテキストエディタで記述し、reStructuredText、AsciiDocなどの軽量マークアップを利用する必要があります。

このようなアプローチの利点は次のとおりです。

プレーンテキストを管理するための優れたツールがあり、それらはすでにプログラマーの手に渡っています（VCS、自動ビルドシステム、diff、パッチ、プログラミングエディター、grepなど）。
マークアップ言語では、フォーマットではなく意図を表現できます。

そのことを念頭に置いて、Wikiは当然の選択のようです。

個人的に私が選んだツールチェーンは次のとおりです。

score 2 · Accepted Answer

イントラネットまたは VPN を使用している場合は、これらの仕様に対応する小さな Wiki をインストールして使用することを実際に検討します。

Google ドキュメントと比較すると、次のようになります。

欠点は、WYSIWYG ではないことです。これは、問題になる場合とそうでない場合があります。

もちろん、より優れたエディターをサポートする Wiki 実装を選択することもできます。また、場合によっては同期コラボレーションエディターをサポートすることもできます。

score 2 · Accepted Answer

2

Google Wave - まさにその目的 - コラボレーション

于 2009-11-04T16:39:49.190 に答える

score 1 · Accepted Answer

に依存すると思います

Googleドキュメントは素晴らしく、簡単に使い始めることができます。また、フォルダを一度にエクスポートできるのも素晴らしいことです。それでも、Webに公開される予定の何かについては、wikiまたは一般的なcmsがより優れたプレゼンテーション手段です。ウィキも既存のサイトと統合されます。

主に1人で作成した小さな仕様がある場合は、プロジェクトコードまたはWebサイトをホストしている場所で利用可能なツールを使用してください。同時に編集する可能性が低い場合は、wikiが適しています。

私はwikiのこと、渡されたドキュメントのこと、そしてGoogleDocsのことをしました。

wikiのものは開始の労力が少なく、かなり長持ちします。特定のサイズでは、それは苦痛になります。
渡されたドキュメント（書き込み、電子メール、編集、電子メールなど）は、1人の人がすべてを起動しているときにのみ機能します。マイナーな編集さえあるとすぐに、それはひどいです。
複数のドキュメントと複数の編集者がいる場合、またはオンラインで公開する場合は、Googleドキュメントで問題ありません。

hth

score 0 · Accepted Answer

これはカードツリーエディターです。つまり、インデックスカードとアウトライナーを組み合わせたものであり、リアルタイムのコラボレーションと Markdown の完全なサポート (および基本的な LaTeX) を備えています。

まだいくつかの機能 (バージョン履歴、コメントなど) が欠けていますが、すべてをツリー構造にすることの利点がこれらの欠点を上回っている場合もあります。

各ユーザーストーリーのカードを作成し、好きなだけ掘り下げることができる (必要に応じて、それらをカテゴリに整理する) ことができるため、それを使用して仕様を記述することは素晴らしいことです。

score 0 · Accepted Answer

これはプログラミングとは関係ありませんが、私は個人的に Google Docs を使用して共有ドキュメントを書き、使いやすいと感じました。

ただし、Google サーバーが一時的にダウンしたり、インターネット接続が利用できない場合に備えて、Google Gears を有効にすることをお勧めします。

7 に答える 7