A 50-word description, beginning with an action verb, such as Introduces or Explains. What You Should Learn List the objectives of the course, beginning each with an observable, measurable verb. Who Should Take this Course List job titles only, do not write a full sentence. Another advantage of using templates is that they help promote consistency among different writers. If several communicators contributing entries to a single reference follow the same template, users are less likely to detect variations in the writing style.
Variations cause confusion for users.
Whenever possible, present information in lists, charts, and diagrams so users can more easily find it. Write in short sentences and phrases. In many instances, you may use sentence fragments. Tell, don't teach. That is, leave out unnecessary explanations.