Class Central is learner-supported. When you buy through links on our site, we may earn an affiliate commission.

Linux Foundation

Explain Yourself! Documentation for Better Code

Linux Foundation via YouTube

Overview

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.

Syllabus

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

Taught by

Linux Foundation

Reviews

5.0 rating, based on 2 Class Central reviews

Start your review of Explain Yourself! Documentation for Better Code

  • Minisha
    The program was very useful and it defiantly will help with making documentation more succinct. This program was simple and very easy to follow.
  • Prabakaran T
    "Chris Ward's documentation guide is a valuable resource for improving code quality through effective documentation practices. It provides insightful tips and examples, making it a must-read for developers seeking to enhance their coding skills."

Never Stop Learning.

Get personalized course recommendations, track subjects and courses with reminders, and more.

Someone learning on their laptop while sitting on the floor.