6

仕様書の作成にどのようなツールを使用しているか知りたいです。SVN のようなソース管理システムで仕様を管理できるように、何らかのプレーン テキスト形式をサポートするツールを使用することが不可欠だと思います。仕様に関してもコードに関しても、すべての変更の履歴を持つことが重要です。

現在、仕様を XML 形式で記述しています。TeX も代替手段になりますが、TeX を使用したことがない人にとっては困難です。

では、仕様書にどのようなツールやフォーマットを使用しているか教えてください。

4

6 に答える 6

4

XXE で編集された DocBook は、必要に応じて xslt で pdf に変換され、クライアントに送信されます。

これまでで最高の変更で、非常に簡単に記述でき、マージも非常に簡単で、変換すると、MSWord のように非常に専門的でないように見えません。

さらに、構造化された文書のスタイルは、作業を開始するために戦わなければならない血まみれの言葉とは異なり、既にそこにあります。

于 2008-09-19T07:19:51.233 に答える
1

TeX (MikTeX) を使用しましたが、次の理由から完璧でした。

  • プレーンテキスト - Vim/メモ帳で編集 - どこでも
  • 私たちの 1 人が行った定義済みのマクロを使用した強力な書式設定
  • PDFへのonclick生成

唯一の問題は、(ArgoUML から) ダイアグラムを取り込むことでした。

別のプロジェクトで、Word テンプレートを使用しているのを見ました。上から指示されたひどいものです。

イントラネットの wiki/forum のようなものを使用することを検討します。GoogleDocs の使用を想像してみてください。バージョン管理があり、オンラインです..しかし、商用開発には適用できません。

于 2008-09-19T07:13:37.443 に答える
1

職場では、多くのドキュメントが Sharepoint やその他のドキュメント システムの下に置かれており、ドキュメントの「リリース」が非常に遅くなります。これは、ドキュメントのコピーがいたるところにあり、誰かに何かを適切にリリースしてもらうのが頭痛の種であることを意味します。このため、私は通常、パワーポイントまたはスクラップペーパーで仕様書を受け取りました。そこで私は、すべてのプロジェクトの仕様を保持する wiki (メディア ウィキ) を職場に設置しました。これにより、社内の誰もがそれらを表示し、開発グループが編集できるようになります。時々、開発者は上司が通りかかったときなどに説明を求めます。開発者は仕様を自分で更新できます。これは大きな利点だと思います。また、

ノートに走り書きしたスペックを今でも忘れないように壁に貼っています。

于 2008-09-22T04:36:39.017 に答える
0

職場では、コラボレーションに最適な wiki を使用していますが、Microsoft Word も使用できます。

Word 自体を使用して、Word 文書の 2 つの異なるバージョンを実際に比較できます。「変更の追跡」機能を使用して相違点を表示します。(信じられない場合は、TortoiseSVN を使用して Word 文書の 2 つのバージョンを比較してみてください。)

長い文書の場合、私は実際には wiki よりも Word を好みます。長い文書の編集には Word が適しているからです。

于 2008-10-16T04:01:02.520 に答える
0

マイクロソフトワード。それがあなたの要件を満たしていないことはわかっていますが、私が経験したすべての仕事で、仕様に Microsoft Word を使用しました。Word 文書をソース管理システムに入れることはできますし、私もそうしています。失われるのは、文書間の差分を取る機能だけです。使用できる単語の差分ツールがあることをどこかで読んだことを漠然と覚えていますが。

于 2008-09-19T07:13:44.570 に答える
0

私はそのようなことすべてにDocbookを使うようになりました。簡単で柔軟性があり、html、tex (および pdf) などを生成します。

于 2008-09-19T07:10:52.363 に答える