Kestrel & Co.
← Back to work

Obsidian — Documentation theme

A docs site for a developer tool, designed so the code samples set the rhythm of the page.

docs.obsidian.dev — live online
Obsidian — project preview

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.