Речь про внутркннюю доку, есличто.
Структура и читаемость - чтобы юзер мог это брать и юзать на своем уровне компетенций.
Ненагруженный, неформальный язык и минимум формализма.
Важнее наличие хотя бы паршивой, верхнеуровневой но хорошо структурированной доки (аля вот эта задача решается примерно по таким шагам, копать туды) но раньше, чем хорошо проработанной, но позже.
Важно, чтобы дока внедрялась и юзалась. Важнее всего и даже текста.