Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

Supporting non writers to write effective content

How can you make a large amount of content work for users when you don’t have the resources to write and maintain it yourself? One solution is to support writers to create user-focused content themselves.

  • Login to see the comments

Supporting non writers to write effective content

  1. 1. Supporting non-writers to write effective content Beth Aitman (@baitman) Technical writer at Improbable 29 January 2018
  2. 2. Game world We make this bit} }
  3. 3. Documentation is content to help developers get stuff done
  4. 4. Documentation is content to help developers get stuff done
  5. 5. We needed our developers to write content
  6. 6. We needed our developers to write content
  7. 7. The product isn’t complete until users know how to use it
  8. 8. What to write
  9. 9. What to write
  10. 10. Keep it minimal
  11. 11. We don’t have a style guide.
  12. 12. We don’t have a style guide.
  13. 13. Reviewing
  14. 14. Reviewing
  15. 15. Training
  16. 16. - Questions to ask before you write documentation eg: Who uses this feature? What is the user task? - Ways to structure writing to make it readable eg: Lots of headings, short paragraphs and sentences, bullet points, using bold - Some writing tips eg: Use the active voice, instruct rather than describe, remove tautologies, front-load sentences Training sessions cover:
  17. 17. Challenges
  18. 18. But it’s worth it!
  19. 19. That’s it. Thanks for listening!

×