アカウント名:
パスワード:
>彼らが週末にサポート業務で待機担当だったり、またアップデート作業で>深夜に作業している時はないだろうか?>追加のドキュメント業務に精を出した彼らにはそういった他業務の負担を>軽くしたりするのも一案だ。
経験上、ドキュメントを作成して顧客や別担当者に渡しても読まれない。全てはそこに書いてあるとしても、ドキュメントを読み漁るよりも携帯電話一本で済まそうとする人間が多すぎるのが根本的な問題なのだ。
プログラマやSEに求められるのは、文筆家のような洗練された文章力と読みやすく校正する編集力、そして興味を引き付けるデザイン力だろうが、それができるならばプログラマなんかしないで本でも書いて印税暮らししてるか、出版社でも経営してるはずだ。
ドキュメントをちゃんと読む人間は一人は確実にいる. それはドキュメントを書いている私だ.
3日前にコードを書き上げて, そのまま逃亡を企てている「私」というプログラマの首根っこを押さえつけて無理やりにでもドキュメントを書かせる.
何故そのような実装になっているのか?
未記載の制限事項は無いか?
ドキュメントとコードを付き合わせてみれば, コードを書くときに考慮不足だったところも見えてくる. だからドキュメント書きはやめられない.
結果, ドキュメントがコードと同量から数倍にふくれることもしばしばで, 上司から怒られることも.
ドキュメントがコードより多いのは普通では?
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
最初のバージョンは常に打ち捨てられる。
読まれないドキュメント (スコア:3, すばらしい洞察)
>彼らが週末にサポート業務で待機担当だったり、またアップデート作業で
>深夜に作業している時はないだろうか?
>追加のドキュメント業務に精を出した彼らにはそういった他業務の負担を
>軽くしたりするのも一案だ。
経験上、ドキュメントを作成して顧客や別担当者に渡しても読まれない。
全てはそこに書いてあるとしても、ドキュメントを読み漁るよりも
携帯電話一本で済まそうとする人間が多すぎるのが根本的な問題なのだ。
プログラマやSEに求められるのは、文筆家のような洗練された文章力と
読みやすく校正する編集力、そして興味を引き付けるデザイン力だろうが、
それができるならばプログラマなんかしないで本でも書いて印税暮らし
してるか、出版社でも経営してるはずだ。
メメント (スコア:2)
ドキュメントをちゃんと読む人間は一人は確実にいる. それはドキュメントを書いている私だ.
3日前にコードを書き上げて, そのまま逃亡を企てている「私」というプログラマの首根っこを押さえつけて無理やりにでもドキュメントを書かせる.
何故そのような実装になっているのか?
未記載の制限事項は無いか?
ドキュメントとコードを付き合わせてみれば, コードを書くときに考慮不足だったところも見えてくる. だからドキュメント書きはやめられない.
結果, ドキュメントがコードと同量から数倍にふくれることもしばしばで, 上司から怒られることも.
Re:メメント (スコア:0)
ドキュメントがコードより多いのは普通では?