使われうる引数や定数は全て詳細に解説を入れといて欲しい(それこそ中国人に仕事投げるときくらい全通り詳細に)
内容を理解するには他の文書を複数参照しないといけませんとか
○○とは××です、××とは○○で使われる数値です
みたいな循環参照じみた手抜き記述やめれ