Oliver Newth

Living Documents

The practice of maintaining evergreen, evolving notes

· 2 min read · budding

Living documents are dynamic notes that evolve over time, continuously updated to reflect current understanding. Unlike static blog posts or finished articles, they embrace impermanence and growth.

Core Principles

Continuous Refinement

  • Start with rough ideas, refine as understanding deepens
  • No note is ever truly "finished"
  • Each revision adds layers of insight

Small, Atomic Thoughts Following the Zettelkasten Method, each document should contain one clear idea that can be linked to others.

Transparency About State

  • Mark notes with status (seedling, growing, evergreen)
  • Date modifications to show evolution
  • Acknowledge gaps and uncertainties
An illustrative revision history moves from an open question to supporting evidence, then a counterexample and a scoped claim. A reader-facing note records current status, last revision, unresolved questions and a reason for the change.
A living document should expose both its present state and what changed. This illustrative revision history combines visible maturity and dates with the practice of revising knowledge maps. Original diagram based on Maggie Appleton, A Brief History & Ethos of the Digital Garden; Novak and Cañas, Institute for Human and Machine Cognition, The Theory Underlying Concept Maps and How to Construct and Use Them.

Why This Matters

Traditional writing creates pressure for perfection. Living documents remove that barrier by embracing the garden metaphor—ideas are planted, tended, and grown rather than manufactured and shipped.

This approach supports:

Linked from