Writing Clear and Interesting Technical Content and Documentation

[tracymakes]

Title

Writing Clear and Interesting Technical Content and Documentation

Description

You’re smart, educated, and you’ve been working in this industry for years. You’ve created amazing open-source packages and great documentation. But all that flies out the window if what you write about your project isn’t being read.

“But it’s comprehensive! It has all the info that I would need!” you may reply.

The problem is not writing for people like you; it’s writing and creating documentation that anyone can read, understand, and get excited about. This is true for projects aimed at beginners, but it goes double for projects and writing aimed at intermediate/expert programmers. Your projects will benefit when you write something that everyone can understand and would want to read. More readers = more users = perhaps more contributors!

Learning objectives

Attendees will learn how to write clearer technical content that reads more naturally (rather than robotic). See this blog post for an overview: https://medium.com/@limedaring/five-tips-for-improving-your-technical-writing-and-documentation-47353723c8a7#.mom27hfey

City of residence

Toronto ON Canada