Modernizing technical documentation
from Just Write Click
As a technical leader at Rackspace during a docs modernization effort, I want to respond to Tom Johnson's recent pointer to the developer docs site as an example of treating docs like code. Not just specifically for the "will it scale" questions, but for the questions I have fielded and continue to answer. Believe me, "Will it scale?" is the least of your concerns in a complex overhaul of attitudes, processes, tooling, and expectation setting. I'm sure modern docs are not going to work for all projects and all people and all processes, but since I have first hand experience I thought it would be helpful to talk about it. In case it helps, let's describe the disruptions at the heart of the movement. You can see that outcomes matter.
7701 Las Colinas Blvd., Ste. 800, Irving, TX 75063