Author: Heidi Waterhouse
-
What is a documentation architect?
When I was at Write the Docs 2015, several people asked me about the title I have in my LinkedIn heading: Documentation Architect. What did I mean by that? How is it different than content management or development architecture? What a documentation architect isn’t A documentation architect isn’t psychic. They can’t figure out your business…
-
The Seven Righteous Fights (Rubyconf, 2015)
Usually we think of compound interest as what adds magically to our retirement or makes our student loans last forever. But there is also a compound interest of technical debt, where a project is made harder and more expensive because of early “cost-saving” choices. I think it’s empowering for developers and other people involved in…
-
The New Sheriff in Town: Bringing Documentation Out of Chaos (Write the Docs, 2014)
By the time we get to mid-career, most of us have specialized, by technology, or organization type, or document type. We have a comfort zone. I have specialized in walking into chaos and creating order. I’ve done it enough times that I have a sequence of steps I follow. I imagine myself as a sheriff walking…
