▪In Concept topics, don’t swamp users with details. Mention only the basics that users should actually memorize. ▪Instead of just mentioning facts, provide explanations. Show how things are related. ▪Use pictures if you can. ▪Use examples and metaphors that help readers relate the information to their own work, knowledge, and experience. ▪Don’t give instructions. For this purpose, use a Task topic instead (see Writing “Task” topics). ▪Don’t provide tables, lists, or diagrams that are mainly intended for users to look up specific data. For this purpose, use a Reference topic instead (see Writing “Reference” topics). |