Refactoring internal documentation in Notion

In our latest developer productivity survey, our documentation was the area with the second most comments. This is a writeup of the concrete steps I took to see how much progress one person could make on improving the organization&rsquo;s documentation while holding myself to a high standard for making changes that actually worked instead of optically sounding impressive. Diagnosis There were a…