In our latest developer productivity survey, our documentationwas the area with the second most comments.This is a writeup of the concrete steps I took to see how muchprogress one person could make on improving the organization’sdocumentation while holding myself to a high standard for makingchanges that actually worked instead of optically sounding impressive.

There were a handful of issues we were running into:

We migrated from Confluence to Notion in January, 2025,which had ...