Explain Yourself! Documentation for Better Code

Discover how to create clear, concise, and usable documentation for your coding projects in this 49-minute conference talk by Chris Ward from Crate.IO. Learn why documentation is crucial, how to explain your point and motivation, create context and meaning, write clear copy, and develop meaningful examples and tutorials. Explore documentation systems, formats, and integration into build processes. Gain insights on testing and versioning documentation. Understand the importance of assuming nothing, keeping content interactive and concise, maintaining consistency, and involving the reader. Improve your technical writing skills to enhance the usability of your libraries and tools for other developers.

Intro
What are they trying to achieve?
Assume nothing
It's not a manual
Interactivity
Involve the reader
Passive vs Active
Keep it short
Structure
Consistency
Format and editing
Write your own