1. React
  2. React Finland
  3. 2020
  4. Humanizing Your Documentation

Humanizing Your Documentation

See how the language we use affects our users, and discover the first steps towards writing accessible, approachable and use case-driven documentation

Carolyn Stransky at React Finland 2020

It’s no secret that most people don’t read technical documentation for pleasure. Users often come to your docs when they are frustrated with your software, disappointed that they haven't been able to solve the problem on their own and generally feeling pretty low. This is sad, sure, but being aware of these feelings is key for developers and technical writers alike. These emotions frame the reader’s perspective and therefore, should shape the mood of our docs. In this talk, we’ll discuss how the language we use affects our users and the first steps towards writing accessible, approachable and use case-driven documentation.