Tag: documentation theory
-
Crosspost from Opensource.com: How Do We Fix the State of Technical Documentation?
If we all agree that open source as a whole has a documentation problem, what can we do to work on addressing and fixing it? How Do We Fix the State of Technical Documentation? We have to talk about why people would be motivated to fix the problem before we can get them to do…
-
The three documents you ACTUALLY need first
Because I work as only-writer for so much of my time, I forget that I’m not just a lone technical writer, and I’m not just an indie, but I’m in an odd category beyond that. Because no one who hires me really knows what a technical writer does, interviewing is often turned on its head…
-
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…