Lightweight Documentation That People Actually Read

# Lightweight Documentation That People Actually Read

The average documentation page: written once, read never. This isn't a documentation problem. It's a weight problem.

Heavy documentation is costly to create, costly to maintain, costly to read. Lightweight documentation inverts this.

Minimum Viable Documentation. What's the least that provides the required value? Write that. Not more.

Write for Retrieval, Not Reading. Clear titles. Scannable headings. Keywords that match searches.

Document at Decision Points. Don't document everything. Document where understanding matters.

Integrate, Don't Separate. Keep docs near code.

Make It Easy to Update. Simple formats. No approval workflows for minor changes.