DEV Community

#documentation

Improving and writing documentation

Posts

👋 Sign in for the ability to sort posts by relevant, latest, or top.
Your Terraform estate documents itself now: meet iac-cartographer

Your Terraform estate documents itself now: meet iac-cartographer

1
Comments
5 min read
Your README Is More Than Documentation

Your README Is More Than Documentation

2
Comments
5 min read
We moved all our docs into Git. Then nobody outside the team could read them.

We moved all our docs into Git. Then nobody outside the team could read them.

3
Comments
2 min read
Docstrings vs Markdown Docs: What Should Developers Actually Write?

Docstrings vs Markdown Docs: What Should Developers Actually Write?

Comments
7 min read
What it takes to build docs worth reading

What it takes to build docs worth reading

9
Comments
4 min read
Checkbox theater: how I stopped trusting my AI agent to run the checks

Checkbox theater: how I stopped trusting my AI agent to run the checks

Comments
8 min read
Everyone Needs a README for Their Life

Everyone Needs a README for Their Life

Comments
5 min read
Turning text into diagrams with AI: field notes from documenting a side project

Turning text into diagrams with AI: field notes from documenting a side project

Comments
3 min read
Technical Writing Advice

Documentation as a system interface

Technical Writing Advice

21
Comments 9
6 min read
How to Write a Killer PCB Design Document (and Why Your Firmware Team Will Thank You)

How to Write a Killer PCB Design Document (and Why Your Firmware Team Will Thank You)

Comments
6 min read
My README said 80 tools. My code had 96. Nobody noticed for weeks.

My README said 80 tools. My code had 96. Nobody noticed for weeks.

2
Comments 6
4 min read
5 Markdown Tricks Every Developer Should Know (That Aren't in the Cheat Sheet)

5 Markdown Tricks Every Developer Should Know (That Aren't in the Cheat Sheet)

Comments
2 min read
How to Create Architecture Overviews from Existing Code

How to Create Architecture Overviews from Existing Code

Comments
7 min read
How We Built Tamper-Evident Document Memory for AI Agents

How We Built Tamper-Evident Document Memory for AI Agents

Comments
3 min read
What Wrong Docs Cost Test Automation Teams

What Wrong Docs Cost Test Automation Teams

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