Survey results for learning and teaching docs-like-code techniques
I asked three questions in a survey emailed to my mailing list and got more than 30 responses. Thanks to everyone who took the time to share their stories and respond. Here are the three questions:
Docs-as-code processes are still new in the field and it seems many of the responses are split, with no overwhelming patterns in any single area. Let’s look into the data and charts for the first two questions.
In a way, nearly all the responses could be viewed as “leadership either supports the selection does not get in the way of tool selection.” For about two-thirds of the responses, either leadership can justify, started the processes, or isn’t a deciding factor.
Looking at the number of lone writer responses in the next question, this indicator makes sense as five of thirty-five respondents noted that they were the only writer in the organization, which would make up 14% of all responses. Let’s take a look.
My favorite answer to this question was one I hadn’t considered, where the person is a lone writer, but works with the devs to get the docs working in the source code repo. It’s along the lines of “It’s complicated.”
