Starting draft of survey results

Author: annegentle

_posts/articles/2021-01-06-survey-results-docs-like-code.md

@@ -0,0 +1,40 @@
+---
+layout: post
+title: Survey Results for learning and teaching docs-like-code techniques
+excerpt: "Review the results of a mid-2020 survey about learning and teaching team mates and yourself how to work with docs like code, Git, and GitHub for technical documentation."
+last_modified_at: Wed Jan  6 11:30:36 CST 2021
+categories: articles
+author: anne_gentle
+tags: [github, git, learning, teaching, documentation, developer, docs-like-code, onboarding]
+image:
+  path: /images/othree-github-stickers.jpg
+  caption: "[Flickr othree](https://flic.kr/p/bGFTuT)"
+comments: false
+share: true
+---
+
+I asked three questions in a survey emailed to my mailing list and got more than 30 responses.
+
+Here are the three questions:
+
+Question 1: When you talk to your leaders about docs-as-code, can they describe the benefits as well as the difficulties?
+
+Question 2: How do you onboard people who are new to your docs tools and processes?
+
+Question 3: What tips or discussions (from any source) was most helpful to you when learning docs-as-code techniques?
+
+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. Here are the charts for the first two questions.
+
+
+![](/images/survey-charts/leadership-docs-tools.png)
+
+
+
+![](/images/survey-charts/how-onboard-docs.png)
+
+
+For question three, I wanted to share any nuggets found in the answers here on the Docs Like Code site, since the goal for this site is to learn these techniques together and share our stories. Here are some highlights. No, this is not a section simply to point to the book, rather, it's to show that having additional resources including people you can ask questions is super valuable when learning how to treat docs like code.
+
+
+
+{% include sign-up.html %}