Overview
Code is the body copy.
The old docs treated code blocks as interruptions, so long procedures read as noise. We set the measure from the longest line of code and let prose adapt to it. Support tickets that began "the docs do not say" fell by a third.
Problem
The old docs treated code blocks as interruptions, so long procedures read as noise.
Approach
We set the measure from the longest line of code and let prose adapt to it.
Outcome
Support tickets that began "the docs do not say" fell by a third.
A docs site for a developer tool, designed so the code samples set the rhythm of the page.
The old docs treated code blocks as interruptions, so long procedures read as noise. We set the measure from the longest line of code and let prose adapt to it.
Support tickets that began “the docs do not say” fell by a third.