目次

  1. ソフトウェア開発に於いてのマニュアルの役割
  2. コードのXPの神話を暴くことはドキュメンテーションである
  3. よいドキュメンテーションの付加的な価値
  4. XPのプロジェクトに於いての技術作家の役割
  5. 概要


ソフトウェア開発に於いてのマニュアルの役割
私はマニュアルの問題 で Ron Jeffriesからの興味深い記事を読んでいた。 私は複数の面の彼の仮定に同意しない。 この記事で私達はソフトウェア開発に於いてのマニュアルの役割を見てみる。 しかし最初に彼がこのトピックで言わなければならないものを見るために割り当てる:

  • ソフトウェア製品をした皆はほとんど誰もマニュアルを読まないことを知っている。 私達は私達が得るテクニカルサポートの問い合わせからのこれを知っている。 私達は私達のほとんどがマニュアルを読まないのでそれを知っている。
  • 網のappsはマニュアルと来ないし、バットを蹴っている。 そのうちのいくつかに幾つかの助けのページがある。 多数にページの指示およびボタンの流れがある。
  • ますますソフトウェアはCDで今日提供され、あなたが得る唯一のマニュアルはCD箱のサイズである。 より多くの人々がそれらの小さい本を読むことが考えた-科学は分った-叙情詩を捜しているとそれをうまく働かせるようである。
  • そしてちょっと: XPのプロジェクトは最も高いビジネスバリューのソフトウェアを最初に造る。 端に原料は始めに原料程に大いに重要ではない!

マニュアルは完全に単純化した買物車のタイプWebアプリケーションのために必要ではない、他の多くのそのような単純化した適用のために必要としたある。 但しマニュアルほとんど誰も読まない」をこと「言うことはある場合もあるので真実にはほど遠い。 あらゆる適度に複雑な企業のクラスの塗布(Siebel、Oracle、SalesForce、Extensityの費用のレポートおよびgazillion主要な方法で台無しにしたいと思わなければ他)重要なユーザーの相互作用を要求し、複雑なビジネス・ロジックをのために表現する、マニュアルを読むことは義務である。

すべての適用が従ってマニュアルを要求しに関してやすい作ることができない。 根本的なビジネス・ロジックは適用の複雑さのある程度を定める。 彼の記事は小さい単純化した適用だけに焦点を合わせられてようである。

私がと働かせたおよび成長するマニュアルのフルセットと来る複数のWebアプリケーション。 マニュアルなしで複合体の生物情報学の適用(NCBIのようなちょうど簡単な調査)を作成する試み。

適当なマニュアルに対する議論の残りは多くの論理なしに政治スピーチタイプである。 従って私は最終的なものを除くポイントそれらをポイント論駁する時間を使わない。

>およびちょっと: XPのプロジェクトは最も高いビジネスバリューのソフトウェアを最初に造る。 端に原料は始めに原料程に大いに重要ではない!

ほとんどの企業の適用のための健康で最も高いビジネスバリューは明確で簡単な言葉にソフトウェアのすべてに理解しやすくさせを含め、それはよく明確なドキュメンテーションを要求する。

地上の現実はよいマニュアルがほとんどの企業の適用のための強い条件であることである。

コードのXPの神話を暴くことはドキュメンテーションである
「コードドキュメンテーション」(XPの信念)切らない現実の世界のそれをである。 不運にも顧客はドキュメンテーションによって呼ばれるコードのこの良い部分を読むことができない。 経糸ガイドの開発者はそのようなドキュメンテーションを容易に 読む ことができない。

別の角度からのこの問題を見よう。 私達はであるドキュメンテーション」開発者自身のための現実ちょうど「コードしてもいいか。

ページ: 1 2