Structured
Good content is structured. It has a job to do, and sometimes two or three jobs at once. For example, the headline on a page helps a user know what the page is about, and it can also help the user find the page in the first place and understand where the page and its content fit within the larger context of the experience. That’s a lot. We have to structure a headline to make sure it accomplishes all those things.
Structure helps us make sure our content is findable, understandable, and effective.
How do we write structured content? Follow content standards and guidelines. We document many of them in the QuickBooks Design System. We’re also developing new templates for documentation, and those will present standards for headlines, subheads, definitions, numbered lists (steps), and other content elements.
Tip: Sentences should usually be active, with simple verbs: Noun, verb, direct object. Keep lists parallel. Draft sentences so that links fall at the end.