Design Docレビューで重要な「代替案・懸念点・未決定事項」を言語化し、優秀さの違いを解説する。
なるほど、選択肢を選んだ理由以外にも選ばなかった理由も、たしかに書くといいよね
難しい言葉や独自用語が少なくて読みやすいのも追加であると思う。主線がすっきりしてて整理されつつ懸念などが書いてあって読みやすい。
このままAIに食わせよう(アカン('ω'乂)
“設計書には、以下をしっかり書いて欲しい。代替案、懸念点、未決定事項”
とりあえず「Design Doc」という表現がいけ好かないなぁ。言っている事は分かるけど。
「本当に頭の良い人はわかりやすい説明ができる」案件じゃないか。この観点では、読み手と書き手のレベル差が小さいことしかわからない。
よくやってる
文章の途中に広告入ってくるの私だけ?普通に誤認してしまう。
優秀なエンジニアが書くDesign Docは何が違うのか? - pospomeのプログラミング日記
Design Docレビューで重要な「代替案・懸念点・未決定事項」を言語化し、優秀さの違いを解説する。
なるほど、選択肢を選んだ理由以外にも選ばなかった理由も、たしかに書くといいよね
難しい言葉や独自用語が少なくて読みやすいのも追加であると思う。主線がすっきりしてて整理されつつ懸念などが書いてあって読みやすい。
このままAIに食わせよう(アカン('ω'乂)
“設計書には、以下をしっかり書いて欲しい。代替案、懸念点、未決定事項”
とりあえず「Design Doc」という表現がいけ好かないなぁ。言っている事は分かるけど。
「本当に頭の良い人はわかりやすい説明ができる」案件じゃないか。この観点では、読み手と書き手のレベル差が小さいことしかわからない。
よくやってる
文章の途中に広告入ってくるの私だけ?普通に誤認してしまう。