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

Correctly attribute copyright and ownership.

It’s important to properly cite sources in all General Products publications, whether online, printed, or projected. If you’ve got a case not covered here, find a way to attribute your source that seems appropriate to the medium. Choosing not to cite your source is an unacceptable alternative.

When including links in external content such as blog posts and ebooks, use anchor text when possible. Linking to other articles and websites is a best practice.

Image attribution

When using photos or images from Flickr or another online source under the Creative Commons license, they must be attributed. When attributing an image, please use the following format and link back to the original source image using the photographer’s name as anchor text.

Image credit: Linked source

Image insertion

Do not put a colon in the text before an image.

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