目標は、次の主要な要件を備えたオンラインドキュメントシステムを用意することです。
- 主に、すべてのアプリケーションの最終的な技術文書の中間段階として使用されます(ただし、おそらく完了しません)。通常は次のように使用されます。誰かに問題があり、それを修正し、修正をすぐに書き留めます。今起こっているのは管理不能なことです。誰かに問題があり、私はそれを修正します。私も誰かも喜んでいますが、2か月後、他の誰かが同じ問題を抱えています。
- どこからでもアクセスでき、Apacheサーバーの背後で実行されます
- ユーザー/グループ管理、読み取り専用/読み取り/書き込み/管理アクセスを許可
- 形式はそれほど重要ではありません:プレーンテキストでもかまいませんが、wikiスタイルの方がいいでしょう
- 安いか無料
私のいくつかのアイデア:
- ファイル共有上またはsshを介してファイルを提供するだけです(短所:Windowsとあまり互換性がない、長所:シンプル、任意のファイルタイプが可能)
- SCMに保存します(svn / git、上記と同じですが、アクセスとアクセスの制御が簡単です)
- Confluence:既にJiraを使用していますが、Confluenceには価値がありますか?Jiraとどのように統合されますか?
- 他に何か?
これらについてコメントすることをorしないでください。他のシステムと経験を共有してください。
ドキュメントはコード(Javadocsなど)から生成されていますか、それともゼロから、ユーザーガイドとして、または2つの組み合わせで作成されていますか?
—
FrustratedWithFormsDesigner
それは主に、よりユーザーガイドではなく、コードのドキュメントのだ(まあ、我々としても、doxygenで生成、我々はそれを含めるかもしれないことを持っているが、それは関心の最初のポイントではありません)
—
stijn
私はスポルスキーにいくらかの現金を引き渡します。
—
ジョブ