I think that's the right track - documentation should offer clarification or examples rather than walls of words or fanciful designs.

As in Unix times of old "Just the facts, please" is a great mission statement I think.