| Your reference 1 is a deep-link that skips the intro. The intro says: > The course designers believe that you are probably comfortable with mathematics. Therefore, this unit begins with an equation: > good documentation = knowledge and skills your audience needs to do a task − your audience's current knowledge and skills > In other words, make sure your document provides the information your audience needs that your audience doesn't already have. Therefore, this unit explains how to do the following: ... This is the kind of fluff that turns many people off. Worse, it is confusing and tries to make a formula out of a sentence. The whole thing could’ve been replaced with the first sentence of the 3rd paragraph I quoted. Your reference 2 contains this gem: > Short sentences communicate more powerfully than long sentences, and short sentences are usually easier to understand than long sentences. And the section title immediately after that sentence is: > Focus each sentence on a single idea |