参考元 Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい - Qiita ポイント 用語は文書内で一貫性をもたせる 曖昧な代名詞の利用は避ける 受動態は避け、能動態を優先する 強い動詞を選択する1 曖昧な動詞よりも意味が限定さ…

一般的にはゴールなどを本人から引き出すことが多いが、個人と組織を踏まえた場合にそのゴールが足りていなくてもそこまで踏み込んで話さないことが多い。 そういう場合には、潜在的なwillをコンサル的に引き出すと良い。 As Is, To Beを引き出すために * 傾…

ソースコメントにはWhy notを書くのが良いと言われている。 (ソース意図について5W1Hに関する情報はコミットログから読み取れるため) そんなソースコメントについて、口語体で開発者の実装当時の気持ちが見え隠れするようなコメントを見かけることがある。 .…