October 4-6 in Berlin, Germany
Register Now for LinuxCon+ContainerCon Europe
Tuesday, October 4 • 14:30 - 15:20
Explain Yourself! Documentation for Better Code - Chris Ward, Crate.IO

Sign up or log in to save this to your schedule, view media, leave feedback and see who's attending!

Explain Yourself! Documentation for Better Code (Chris Ward) - How many times have you come across an awesome looking library or tool that you're keen to work with in your own project but can't even begin to understand how to use it?

Programmers are great at creating amazing and cutting-edge code, but not always so good and explaining themselves, and I want to help. In this presentation I want to draw upon my experience in writing tutorials and technical documentation to help you write clear, concise and usable documentation for your own projects.

We will cover topics such as:

- Why write documentation?
- Explaining your point and motivation
- Creating context and meaning
- Writing clear copy
- Creating meaningful examples and tutorials
- Documentation systems and formats
- Making documentation part of build processes
- Testing Docs
- Versioning of Docs

avatar for Chris Ward

Chris Ward

Developer Advocate, Crate.IO
Developer Relations, Technical Writing and Editing, (Board) Game Design, Education, Explanation and always more to come.

Tuesday October 4, 2016 14:30 - 15:20 CEST
Potsdam I/II