DEV Community

#documentation

Improving and writing documentation

Posts

đź‘‹ Sign in for the ability to sort posts by relevant, latest, or top.
Catch Broken Markdown Links and #Anchors Offline Before They Hit Production with DeadLinkFinder

Catch Broken Markdown Links and #Anchors Offline Before They Hit Production with DeadLinkFinder

1
Comments
3 min read
Why File Organization Should Be Semantic, Not Filename-Based

Why File Organization Should Be Semantic, Not Filename-Based

Comments
5 min read
The Three-Layer System for Consistent AI Specifications

The Three-Layer System for Consistent AI Specifications

Comments
10 min read
Your README Is Lying to You: Test Your Onboarding Docs Like You Test Code

Your README Is Lying to You: Test Your Onboarding Docs Like You Test Code

Comments
7 min read
Freeze a Reader Contract Before Models Draft Tutorial Pages

Freeze a Reader Contract Before Models Draft Tutorial Pages

Comments
9 min read
Block Unregistered Facts Before a Model Drafts a Concept Page

Block Unregistered Facts Before a Model Drafts a Concept Page

1
Comments
10 min read
Merge Documentation by Heading So Models Cannot Replace Owned Sections

Merge Documentation by Heading So Models Cannot Replace Owned Sections

Comments
10 min read
Draft the Migration Note. Refuse the Unsigned Number.

Draft the Migration Note. Refuse the Unsigned Number.

Comments
7 min read
From Markdown to Explainer Video: A Developer's Workflow for Documentation People Actually Watch

From Markdown to Explainer Video: A Developer's Workflow for Documentation People Actually Watch

1
Comments
4 min read
Terminology drift is the quiet tax on a large content corpus

Terminology drift is the quiet tax on a large content corpus

Comments
3 min read
Modeling Waterfront Assets with Shapezo: A Typed Content Pipeline for Docks, Piers, and Wharves

Modeling Waterfront Assets with Shapezo: A Typed Content Pipeline for Docks, Piers, and Wharves

Comments
2 min read
Keep Escalation Facts Out of Model-Drafted Troubleshooting Pages

Keep Escalation Facts Out of Model-Drafted Troubleshooting Pages

Comments
9 min read
Why Most User Documentation Fails (And How to Fix Yours)

Why Most User Documentation Fails (And How to Fix Yours)

1
Comments
4 min read
A README skill that deletes claims it cannot source

A README skill that deletes claims it cannot source

1
Comments 3
3 min read
How to Generate API Documentation from an OpenAPI Spec (2026 Guide)

How to Generate API Documentation from an OpenAPI Spec (2026 Guide)

Comments
5 min read
đź‘‹ Sign in for the ability to sort posts by relevant, latest, or top.