Skip to main content

The four main documentation strategies explained

Clients frequently ask us for advice on how to approach their documentation workflows. These aren't really questions about the inner workings of Swimm's components, but are more along the lines of figuring out how to focus their writing efforts.

We suggest thinking of it more as a strategy than an absolute plan on who is going to write what, and when. There are four main themes that go into a documentation strategy.

Most Strategies Are A Combination Of These Approaches:
Firefighting involves creating the level of documentation appropropriate for the area of the code as needed to answer questions as they arise.

Most new codebases begin with a firefighting strategy coupled with some task-oriented guides to help new contributors set up and accomplish common things. Code that lacks documentation might benefit from a breadth-first pass and then firefighting as needed.

Customer-facing documentation generally requires a depth-first/breadth-second combo. But, whatever you do, it's likely going to be a combination of two or more of these.

You can read a more in-depth discussion of how these approaches go into an overall documentation strategy in our blog post about documentation strategies.. This is also available as a video presentation.

Watch This 10 Minute Presentation Of How These Approaches Work: