Skip to content

Commit e76bfbe

Browse files
Docs intro: add Diátaxis reference to framing paragraph
Links out to diataxis.fr as the framework that shapes how I structure documentation. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent fa99984 commit e76bfbe

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

docs/intro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ sidebar_position: 1
66

77
When I started my career in docs engineering, I thought documentation was just about explaining how things work. After years of working with developers at companies like Ably, Couchbase, and Atlas Copco, I've learned that great documentation is really about enabling people to succeed with complex technology.
88

9-
My focus has been on taking complicated systems - from real-time messaging platforms to industrial manufacturing equipment - and creating documentation that developers and engineers can actually use to solve real problems. Each project taught me something different about how people learn and implement technology.
9+
My focus has been on taking complicated systems - from real-time messaging platforms to industrial manufacturing equipment - and creating documentation that developers and engineers can actually use to solve real problems. Each project taught me something different about how people learn and implement technology. The framework I keep returning to is [Diátaxis](https://diataxis.fr/), which splits docs into tutorials, how-tos, reference, and explanation so readers can find what they need in the mode they are actually in.
1010

1111
<div className="work-section">
1212

0 commit comments

Comments
 (0)