タグ

開発とドキュメントに関するmohnoのブックマーク (2)

  • アメリカの職場ではなぜドキュメントも無いのに人が去っても問題ないのだろう?|牛尾 剛

    アメリカの職場にいると、日にいるときよりも身近でレイオフだとか、職を変えるというのを頻繁に見かける。先日もそういう場面があったのだが昔日で働いていた時のことを思い出した。 ドキュメントを書く理由 日のソフトウェア企業にいたときは、「納品物であるから」という理由以外にも、「人がいなくなったときに会社が困るから」という理由でもドキュメントを書くことが推奨されていた。しかし、少なくとも今の職場ではそんな理由でドキュメントを書くのは推奨されていないのに、なぜ問題にならないのだろうとふと思った。 うちのマネージャは、バディ制ににして、みんな休暇できるようにしようとは言っているが、多分当に退職対策ではないと思う。 チームのメンバーが抜けたときも、「とても残念で、ワークロードをどうしようという問題はあるけど、彼女の門出を祝福しよう」言っていた。つまり、こちらでも「工数」は問題になるけど、「引継ぎ

    アメリカの職場ではなぜドキュメントも無いのに人が去っても問題ないのだろう?|牛尾 剛
    mohno
    mohno 2023/05/30
    主語がデカい。「「誰でも書けるコード」に寄せることはしない」←だからドキュメントがあっても引き継ぎできない、という組織なわけで(Microsoftが)。開発してる人が辞めたら塩漬けになっちゃうでしょ。
  • プロダクト開発でドキュメントを書かないとどうなるか

    Agile Manifestoには以下のように書いてあります。 動作するソフトウエアは包括的なドキュメントにまさる ともするとドキュメント軽視と取られかねない宣言です。この宣言を誤って解釈してドキュメントはいらないとなる場合もあるかもしれませんが筆者はそれは間違いだと思っています。この宣言では包括的なドキュメントよ

    プロダクト開発でドキュメントを書かないとどうなるか
    mohno
    mohno 2022/02/09
    再構築するために必要なドキュメントは必要だし、そうでない情報は理解の邪魔になりそう、ということはある。インターフェイス(関数)の仕様は書いても、プログラムの隣に逐一コメントを書くな、というか。
  • 1