Writing

    Principles

  1. Accessible content

  2. Style and tone

  3. General guidelines

  4. Link text

  5. Formatting

  6. UI elements

  7. Language

  8. Attribution

  9. File names

  10. Punctuation

  11. Task-specific guidelines

  12. In-depth articles

  13. File structure

  14. How-to documentation

  15. Images

    Image optimisation

  16. Image optimisation

  17. Logos

  18. Logos

  19. Colour

    Accessible colours

  20. Accessible colours

  21. Typography

    Fonts

  22. Fonts

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.

Schedule a call to see Consonance in action and discuss your own situation. If you have your data in the ONIX format, send it over and we'll import it, to make the call particularly interesting.

Contact us