仕様書など資料の作成時に、あなたは何を一番気にして作成しますか？
との問いに、みなさんはどのようなことをお考えになるのでしょうか？

私は、『読み手を意識して作成します』です。

例えば、仕様概要書を作成する場合、読む相手（お客様）がどんな方かを意識して作るようにしています。
開発者には事実を正確に伝えることが必要ですが、お客様に対しては、お客様がご理解いただけるような記載を心がけます。

もちろん、嘘はいけません。

ですが、エンジニアから見ればちょっと違う！となっても、
大きく違っていないのであれば、そういう意訳のやり方もアリとおいてます。
何となくでも、正しい方向に想像してもらえることが重要と思うからです。

とはいうものの、
技術内容をお伝えすることは非常に難しい。なかなかうまくいきません。
後になってから、
『やっぱりこんな書き方じゃ伝わらない』
という後悔は未だによくあります。

日々精進です。