2023-04-04

anond:20230404115609

ある程度システム理解した後じゃないとドキュメント読んでも書いてあること理解できないので時間無駄

記事への反応 -
  • 私は長くソフトウェアの業界で技術者として働いていて、ドキュメントを書くべきだって多くの人が言うのを見てきた。それには賛成するものの、過去の経緯や決断、知見を文書にした...

    • ある程度システムを理解した後じゃないとドキュメント読んでも書いてあること理解できないので時間の無駄

    • ソースコードに書けばいいじゃん

    • 「今回の障害の原因を答えてください」  ↓ 「えー」(ホントの原因なんか言えるわけないだろ)  ↓ 「ドキュメント類はどうなっていましたか?」  ↓ 「存在しまいたがアップデート...

      • とても頑張ってプログラム書いたのですが、バグがあったようです 次から気をつけます

    • IBMとOracleのドキュメントが壊滅的に読みづらいのはなんとかならんかなぁとは思う。 お前の言ってるドキュメント、そのレベルのものじゃないよな?

    • 寝る時に読み聞かせしてあげようか?

記事への反応(ブックマークコメント)

ログイン ユーザー登録
ようこそ ゲスト さん