<div dir="ltr">Hi all, <div>We all want to increase the number of doc contributors while still producing and maintaining quality documentation for OpenStack. I want to gather data from our community about what limits people from contributing to documentation. </div>

<div><br></div><div>I've put together this survey [1] and I would like to send it out by Friday this week. Can you take a few minutes to review and offer input by 22:00 UTC Thursday (tomorrow)? What questions am I not asking? Are these worded in such a way that we'll get actionable data? </div>

<div><br></div><div>Thanks for your help and interest in this area!</div><div>Anne</div><div>[1] <a href="https://docs.google.com/forms/d/136-BssH-OxjVo8vNoOD-gW4x8fDFpvixbgCfeV1w_do/edit?usp=sharing">https://docs.google.com/forms/d/136-BssH-OxjVo8vNoOD-gW4x8fDFpvixbgCfeV1w_do/edit?usp=sharing</a></div>

<div><br></div><div><div class="" style="color:rgb(0,0,0);font-family:sans-serif,sans-serif;font-size:13px;background-color:rgb(247,247,247)"><div dir="ltr" class="" style="margin:12px 0px"><div class="" style="margin-bottom:1.5em">

<label class="" for="entry_1313778435"><div class="" style="font-weight:bold">Have you contributed to OpenStack Documentation in the last year? <label for="itemView.getDomIdToLabel()"></label><span class="" style="color:rgb(196,59,29)">*</span></div>

<div class="" dir="ltr" style="margin:0.1em 0px 0.25em;color:rgb(102,102,102)">You contributed if you made a patch to your <project>/doc folder, openstack-manuals, api-site, object-api, image-api, identity-api, compute-api, volume-api, netconn-api, operations-guide, or database-api or if you reviewed a patch or if you logged a doc bug for openstack-manuals or openstack-api-site. Whew!</div>

</label><ul class="" style="list-style:none;padding:0px;margin:0.5em 0px 0px"><li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="radio" name="entry.1080929367" value="Yes" id="group_1080929367_1" class="" style="vertical-align:middle"></span> <span class="">Yes</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="radio" name="entry.1080929367" value="No" id="group_1080929367_2" class="" style="vertical-align:middle"></span> <span class="">No</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="radio" name="entry.1080929367" value="I don't know; what counts as a doc contribution?" id="group_1080929367_3" class="" style="vertical-align:middle"></span> <span class="">I don't know; what counts as a doc contribution?</span></label></li>

</ul></div></div></div><div class="" style="color:rgb(0,0,0);font-family:sans-serif,sans-serif;font-size:13px;background-color:rgb(247,247,247)"><div dir="ltr" class="" style="margin:12px 0px"><div class="" style="margin-bottom:1.5em">

<label class="" for="entry_841021643"><div class="" style="font-weight:bold">If you've contributed, how did you do so? <label for="itemView.getDomIdToLabel()"></label><span class="" style="color:rgb(196,59,29)">*</span></div>

<div class="" dir="ltr" style="margin:0.1em 0px 0.25em;color:rgb(102,102,102)">Check all that apply</div></label><ul class="" style="list-style:none;padding:0px;margin:0.5em 0px 0px"><li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em">

<label><span class=""><input type="checkbox" name="entry.283831144" value="Created and landed a patch for openstack-manuals" id="group_283831144_1" class="" style="vertical-align:middle"></span> <span class="">Created and landed a patch for openstack-manuals</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.283831144" value="Created and landed a patch for api-site or <project>-api" id="group_283831144_2" class="" style="vertical-align:middle"></span> <span class="">Created and landed a patch for api-site or <project>-api</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.283831144" value="Created and landed a patch for a <project>/doc developer doc" id="group_283831144_3" class="" style="vertical-align:middle"></span> <span class="">Created and landed a patch for a <project>/doc developer doc</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.283831144" value="Created but didn't land a patch " id="group_283831144_4" class="" style="vertical-align:middle"></span> <span class="">Created but didn't land a patch </span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.283831144" value="Reviewed a doc patch" id="group_283831144_5" class="" style="vertical-align:middle"></span> <span class="">Reviewed a doc patch</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.283831144" value="Logged a doc bug" id="group_283831144_6" class="" style="vertical-align:middle"></span> <span class="">Logged a doc bug</span></label></li>

</ul></div></div></div><div class="" style="color:rgb(0,0,0);font-family:sans-serif,sans-serif;font-size:13px;background-color:rgb(247,247,247)"><div dir="ltr" class="" style="margin:12px 0px"><div class="" style="margin-bottom:1.5em">

<label class="" for="entry_294805782"><div class="" style="font-weight:bold">What obstacles prevent you from contributing to OpenStack documentation?</div><div class="" dir="ltr" style="margin:0.1em 0px 0.25em;color:rgb(102,102,102)">

Check all that apply</div></label><ul class="" style="list-style:none;padding:0px;margin:0.5em 0px 0px"><li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.700382988" value="The git/gerrit workflow stumps me and isn't in my normal work environment" id="group_700382988_1" class="" style="vertical-align:middle"></span> <span class="">The git/gerrit workflow stumps me and isn't in my normal work environment</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.700382988" value="I'm allergic to DocBook and WADL because XML" id="group_700382988_2" class="" style="vertical-align:middle"></span> <span class="">I'm allergic to DocBook and WADL because XML</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.700382988" value="My team doesn't value documentation like code so why bother" id="group_700382988_3" class="" style="vertical-align:middle"></span> <span class="">My team doesn't value documentation like code so why bother</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.700382988" value="Documentation writing is not interesting to me" id="group_700382988_4" class="" style="vertical-align:middle"></span> <span class="">Documentation writing is not interesting to me</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.700382988" value="Every time I want to contribute to docs, I can't figure out where to put the thing I know" id="group_700382988_5" class="" style="vertical-align:middle"></span> <span class="">Every time I want to contribute to docs, I can't figure out where to put the thing I know</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.700382988" value="I didn't think I knew enough to contribute to official OpenStack documentation" id="group_700382988_6" class="" style="vertical-align:middle"></span> <span class="">I didn't think I knew enough to contribute to official OpenStack documentation</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.700382988" value="My project is incubating so it's outside of the OpenStack documentation mission" id="group_700382988_7" class="" style="vertical-align:middle"></span> <span class="">My project is incubating so it's outside of the OpenStack documentation mission</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.700382988" value="When I've tried to patch documentation, the review process got me down, too long, too nit-picky, or too many cooks in the kitchen on my patch" id="group_700382988_8" class="" style="vertical-align:middle"></span> <span class="">When I've tried to patch documentation, the review process got me down, too long, too nit-picky, or too many cooks in the kitchen on my patch</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.700382988" value="The doc tools themselves are heavy handed, prescriptive, and too opinionated" id="group_700382988_9" class="" style="vertical-align:middle"></span> <span class="">The doc tools themselves are heavy handed, prescriptive, and too opinionated</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.700382988" value="Testing doc patches requires an OpenStack environment I don't have set up or access to in a lab" id="group_700382988_10" class="" style="vertical-align:middle"></span> <span class="">Testing doc patches requires an OpenStack environment I don't have set up or access to in a lab</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.700382988" value="I think someone else should write the documentation, not me" id="group_700382988_11" class="" style="vertical-align:middle"></span> <span class="">I think someone else should write the documentation, not me</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.700382988" value="I would only contribute documentation if I were paid to do so; it isn't a volunteer effort" id="group_700382988_12" class="" style="vertical-align:middle"></span> <span class="">I would only contribute documentation if I were paid to do so; it isn't a volunteer effort</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.700382988" value="__other_option__" id="group_700382988_13" class="" style="vertical-align:middle"></span> Other:</label> <span class=""><input type="text" name="entry.700382988.other_option_response" value="" class="" id="entry_700382988_other_option_response" dir="auto" style="vertical-align:middle"></span></li>

</ul></div></div></div><div class="" style="color:rgb(0,0,0);font-family:sans-serif,sans-serif;font-size:13px;background-color:rgb(247,247,247)"><div dir="ltr" class="" style="margin:12px 0px"><div class="" style="margin-bottom:1.5em">

<label class="" for="entry_289804411"><div class="" style="font-weight:bold">Generally does your team value documentation for contributors? For deployers? For end-users?</div><div class="" dir="ltr" style="margin:0.1em 0px 0.25em;color:rgb(102,102,102)">

</div></label><ul class="" style="list-style:none;padding:0px;margin:0.5em 0px 0px"><li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.212924700" value="Yes, of course" id="group_212924700_1" class="" style="vertical-align:middle"></span> <span class="">Yes, of course</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.212924700" value="Honestly, no" id="group_212924700_2" class="" style="vertical-align:middle"></span> <span class="">Honestly, no</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.212924700" value="Wait, is this a trick question?" id="group_212924700_3" class="" style="vertical-align:middle"></span> <span class="">Wait, is this a trick question?</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.212924700" value="Yes, but only one of those audiences:" id="group_212924700_4" class="" style="vertical-align:middle"></span> <span class="">Yes, but only one of those audiences:</span></label></li>

<li class="" style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span class=""><input type="checkbox" name="entry.212924700" value="__other_option__" id="group_212924700_5" class="" style="vertical-align:middle"></span> Other:</label> <span class=""><input type="text" name="entry.212924700.other_option_response" value="" class="" id="entry_212924700_other_option_response" dir="auto" style="vertical-align:middle"></span></li>

</ul></div></div></div></div></div>