It's good advice, but I think that like a lot of such articles it's talking about how to run, when there's a need for more articles on how to walk. That is, th

It's good advice, but I think that like a lot of such articles it's talking about how to run, when there's a need for more articles on how to walk. That is, the first duty of technical documentation is to be complete and correct (at least for practical purposes). Once you've got that far it's time to pay attention to optimising it for the needs of your likely readers.