Writing Inclusive Documentation
Presented by Alanna Burke
Documentation is only useful if people can read it, so it stands to reason that it needs to be accessible. But what about making it inclusive? What does that entail? How can we make sure that everyone is benefitting fully from our documentation AND feeling as though they are the intended audience? Open source projects especially can sometimes make people feel as though they don’t belong - don’t lose your audience because you didn’t think through your writing carefully!
In this session, we’ll discuss how to make sure your documentation can be read and understood by everyone. We’ll talk about strategies to make your writing as clear as possible, which can be difficult when using big technical terms and complex ideas. Have you ever thought about what NOT to say in your documentation - what can be off-putting and make people feel excluded? That’s an important aspect, but one that’s often overlooked, so we’ll go over some things to watch out for. Formatting, layout, and accessibility are also important, so we’ll review some best practices. We’ll also cover some content strategy - making sure your users and readers have access to all of the information they need requires some planning.
At the end of this session, you will come away with an actionable list of items and fixes to apply to your documentation.