月並みですが、私がdoxygenなどでソースコードにドキュメントを書くとき気をつけていることです。目指しているのは「練習しなくても誰でも速読できる文書を書く」方法です。普通の言葉遣いとは似て非なる、近いのに遠いとっつきにくさがありますが、一度慣れ…