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.
How to write
inclusive tech documentation
Lucie Le Naour
Agenda
• What is inclusive documentation?
• Why should documentation be inclusive?
• Some best practices
• Q&A (or debate?...
Inclusivity
Inclusive documentation is a documentation that takes into
account all of its users, regardless of their gende...
Because you are writing for your user!
How to write inclusive tech documention - Lucie Le Naour Write the Docs Meetup - Au...
How to write inclusive tech documention - Lucie Le Naour Write the Docs Meetup - August 2019
Some best practices
Educate y...
How to write inclusive tech documention - Lucie Le Naour Write the Docs Meetup - August 2019
Some best practices
Educate y...
How to write inclusive tech documentation - Lucie Le Naour Write the Docs Meetup - August 2019
Some best practices
Use lan...
How to write inclusive tech documentation - Lucie Le Naour Write the Docs Meetup - August 2019
Some best practices
Use lan...
How to write inclusive tech documentation - Lucie Le Naour Write the Docs Meetup - August 2019
Some best practices
Use des...
How to write inclusive tech documentation - Lucie Le Naour Write the Docs Meetup - August 2019
Q&A
Shoot!
Upcoming SlideShare
Loading in …5
×

How to write inclusive tech documentation

362 views

Published on

This is a presentation I gave at the Write The Docs Berlin meetup on the 19th of August 2019, on my behalf. During this presentation I talked about how to use language and design to create a technical documentation that is inclusive of all its users.

Published in: Technology
  • Be the first to comment

How to write inclusive tech documentation

  1. 1. How to write inclusive tech documentation Lucie Le Naour
  2. 2. Agenda • What is inclusive documentation? • Why should documentation be inclusive? • Some best practices • Q&A (or debate?) How to write inclusive tech documention - Lucie Le Naour Write the Docs Meetup - August 2019
  3. 3. Inclusivity Inclusive documentation is a documentation that takes into account all of its users, regardless of their gender, culture, abilities, etc. How to write inclusive tech documention - Lucie Le Naour Write the Docs Meetup - August 2019 What is inclusive documentation? „The quality of trying to include many different types of people and treat them all fairly and equally.“ - Cambridge Dictionary Inclusive documentation
  4. 4. Because you are writing for your user! How to write inclusive tech documention - Lucie Le Naour Write the Docs Meetup - August 2019 Why should documentation be inclusive? This Photo by Unknown Author is licensed under CC BY-SA Rubber stamp template: www.presentationmagazine.com This Photo by Unknown Author is licensed under CC BY-SA THE USERYOU
  5. 5. How to write inclusive tech documention - Lucie Le Naour Write the Docs Meetup - August 2019 Some best practices Educate yourself… … by exchanging with the people in your life This Photo by Unknown Author is licensed under CC BY-SA-NC
  6. 6. How to write inclusive tech documention - Lucie Le Naour Write the Docs Meetup - August 2019 Some best practices Educate yourself… … by paying attention to the news This Photo by Unknown Author is licensed under CC BY-NC
  7. 7. How to write inclusive tech documentation - Lucie Le Naour Write the Docs Meetup - August 2019 Some best practices Use language as a tool! • Language shapes the way humans think: listen cognitive scientist Lera Boroditsky talk about it here. • The words you choose matter: latest studies show for example that the use of gender-neutral pronouns boosts positive feelings towards women and LGBT people, read about it here and here. • The words you choose definitely matter: AI using language corpora has been shown to reproduce human biases, read about it here and here.
  8. 8. How to write inclusive tech documentation - Lucie Le Naour Write the Docs Meetup - August 2019 Some best practices Use language as a tool! © Lucie Le Naour
  9. 9. How to write inclusive tech documentation - Lucie Le Naour Write the Docs Meetup - August 2019 Some best practices Use design as a tool! • Design your documentation for guidance: use multiple formats and place the information where different users need it, Microsoft explains it better here. • Steal from your UI/UX colleagues: start using inclusive visuals in your docs, read about it here.
  10. 10. How to write inclusive tech documentation - Lucie Le Naour Write the Docs Meetup - August 2019 Q&A Shoot!

×