ドキュメントの神話 -ドキュメントを欲しがるやつにはソースコードを渡せ-

に公開

しかしながら、ソースコードは既に渡してあることがほとんどであり、
彼らはソースコードの開き方を知らない。

よって、我々はソースコードをそのまま**“ドキュメントとして”書き直す**仕事を行うことになる。

結果的に、スケジュールは大幅に遅れ、
バグだらけの製品がリリースされ、
我々は再び、終わらない戦いへとその身を投じることとなる。

構造が見えていない者が、構造を要求する。
そしてそれに応え続ける限り、我々に平穏は訪れない。

Discussion