Last year and this, presenters talked about developing a culture of internal developer docs. Their talks were inspiring. Do other folks have stories to tell about similar efforts? Or lack thereof and lamentations therefore?
I’m one of a group of four writers at my company trying to get more visibility – and more resources – for internal dev docs. A few projects are pushing hard from the engineering side for writer resources, but there’s also resistance on the part of both upper management and some (other) engineering teams. So our situation is pretty ad hoc and project-dependent. We’re planning to discuss the situation formally at an upcoming internal gabfest.
What can y’all tell us about how dev docs are managed in your situation? Are writers involved? If yes, how many? Are devs required to write docs? Anything else at all? We’re looking for inspiration! (and yes, we know the Twitter and Google stories, at least as they’ve been presented at WTD …)
(And if y’all want to see a bit of what one of our teams is doing, I describe it a bit in the topic about API Documentation Generation Workflows)