Write effective, consistent how-to documentation to help users get quick answers and thorough guidance

Naming articles

The section heading is How to, so the title should follow on nicely from that, starting with a verb, not a gerund (a verb acting as a noun, which ends in -ing).

Do:

  • Add
  • Generate

Don’t:

  • Adding
  • Generating

Headings

Number the headings.

  1. Go to the products page
  2. Filter your selection
  3. Click on the work

Repeat any instructions in headers in the body text.

3) Click Save and add more information

Click Save. Once you have saved the basics, the page refreshes with two additional sections.