DEV Community

#documentation

Improving and writing documentation

Posts

👋 Sign in for the ability to sort posts by relevant, latest, or top.
Developers sign up but never call your API

Developers sign up but never call your API

Comments
5 min read
Building a Tested, High-Performance Docs Site with Thally (and What It Taught Me About Modern DX)

Building a Tested, High-Performance Docs Site with Thally (and What It Taught Me About Modern DX)

Comments
7 min read
Your README Renders Differently on GitHub and in VS Code: What Works Where

Your README Renders Differently on GitHub and in VS Code: What Works Where

Comments
5 min read
Retire a Draft Before It Ships: Edit-Distance Budgets for Model-Written Docs

Retire a Draft Before It Ships: Edit-Distance Budgets for Model-Written Docs

Comments
7 min read
Diff-Only Drafting: Give the Model a Patch Budget and Let CI Audit the Churn

Diff-Only Drafting: Give the Model a Patch Budget and Let CI Audit the Churn

Comments 1
8 min read
Markdown in Confluence Cloud in 2026: what actually works

Markdown in Confluence Cloud in 2026: what actually works

Comments
3 min read
Falsify Before You Read: A Claim Registry That Runs Before Anyone Reviews Model-Drafted Docs

Falsify Before You Read: A Claim Registry That Runs Before Anyone Reviews Model-Drafted Docs

Comments
7 min read
Draft the Reason, Own the Undo: Splitting Model-Written Docs by Blast Radius

Draft the Reason, Own the Undo: Splitting Model-Written Docs by Blast Radius

Comments
6 min read
Editing code samples in documentation: what I check before they ship

Editing code samples in documentation: what I check before they ship

Comments
4 min read
Your static site generator can catch broken links at build time. Here's how in 6 popular ones

Your static site generator can catch broken links at build time. Here's how in 6 popular ones

Comments
5 min read
Fence the Human-Owned Paragraphs: A Markdown Contract for Model-Assisted Docs

Fence the Human-Owned Paragraphs: A Markdown Contract for Model-Assisted Docs

Comments
8 min read
Docs as Code with Confluence

Docs as Code with Confluence

Comments
5 min read
Docusaurus vs MkDocs Material vs VitePress vs Starlight: Open Source Docs With Versioning, i18n and Self-Hosted Search

Docusaurus vs MkDocs Material vs VitePress vs Starlight: Open Source Docs With Versioning, i18n and Self-Hosted Search

1
Comments
17 min read
A test that fails when your docs lie

A test that fails when your docs lie

Comments
3 min read
Forty-six research dossiers, 702,000 words, 3,750 source URLs, and three that shipped as articles instead of products

Forty-six research dossiers, 702,000 words, 3,750 source URLs, and three that shipped as articles instead of products

Comments
5 min read
👋 Sign in for the ability to sort posts by relevant, latest, or top.