ドキュメントハックス

ドキュメント作成の各工程での、筆者のハックスが充実しています。

これらのハックスには、その理由がキチンと書かれています。
そうだなぁと、納得させられるものが多いです。

例えば、『「わかりやすい」は売り文句にしない』では、
その理由の1つとして、「わかりやすい」を売り文句にすると、
読み手がそれを期待するため、わかりにくい文章を見つけると
マイナス評価してしまうこと、を挙げています。

ドキュメントには表れない、それから醸し出るアイディア、
考え方、工夫は、ハックスに通じるものがあります。

チームでドキュメント作成する時の手引きにもいいと思います。