<div dir="ltr">Hi all, <div>Some changes are now available based on input, thanks for taking a look! Keep it coming, I can keep making changes for the next 8 hours or so.</div><div>Thanks,</div><div>Anne</div></div><div class="gmail_extra">

<br><br><div class="gmail_quote">On Wed, Apr 2, 2014 at 2:46 PM, Anne Gentle <span dir="ltr"><<a href="mailto:anne@openstack.org" target="_blank">anne@openstack.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

<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" target="_blank">https://docs.google.com/forms/d/136-BssH-OxjVo8vNoOD-gW4x8fDFpvixbgCfeV1w_do/edit?usp=sharing</a></div>


<div><br></div><div><div style="font-size:13px;background-color:rgb(247,247,247);font-family:sans-serif,sans-serif"><div dir="ltr" style="margin:12px 0px"><div style="margin-bottom:1.5em">
<label><div style="font-weight:bold">Have you contributed to OpenStack Documentation in the last year? <label></label><span style="color:rgb(196,59,29)">*</span></div>
<div 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 style="list-style:none;padding:0px;margin:0.5em 0px 0px"><li style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span><input type="radio" name="entry.1080929367" value="Yes" style="vertical-align:middle"></span> <span>Yes</span></label></li>


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


</ul></div></div></div><div style="font-size:13px;background-color:rgb(247,247,247);font-family:sans-serif,sans-serif"><div dir="ltr" style="margin:12px 0px"><div style="margin-bottom:1.5em">
<label><div style="font-weight:bold">If you've contributed, how did you do so? <label></label><span style="color:rgb(196,59,29)">*</span></div>
<div dir="ltr" style="margin:0.1em 0px 0.25em;color:rgb(102,102,102)">Check all that apply</div></label><ul style="list-style:none;padding:0px;margin:0.5em 0px 0px"><li style="margin:0px;line-height:1.3em;padding-bottom:0.5em">


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


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


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


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


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


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


</ul></div></div></div><div style="font-size:13px;background-color:rgb(247,247,247);font-family:sans-serif,sans-serif"><div dir="ltr" style="margin:12px 0px"><div style="margin-bottom:1.5em">
<label><div style="font-weight:bold">What obstacles prevent you from contributing to OpenStack documentation?</div><div dir="ltr" style="margin:0.1em 0px 0.25em;color:rgb(102,102,102)">
Check all that apply</div></label><ul style="list-style:none;padding:0px;margin:0.5em 0px 0px"><li style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span><input type="checkbox" name="entry.700382988" value="The git/gerrit workflow stumps me and isn't in my normal work environment" style="vertical-align:middle"></span> <span>The git/gerrit workflow stumps me and isn't in my normal work environment</span></label></li>


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


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


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


<li style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span><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" style="vertical-align:middle"></span> <span>Every time I want to contribute to docs, I can't figure out where to put the thing I know</span></label></li>


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


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


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


<li style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span><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" style="vertical-align:middle"></span> <span>Testing doc patches requires an OpenStack environment I don't have set up or access to in a lab</span></label></li>


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


<li style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span><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" style="vertical-align:middle"></span> <span>I would only contribute documentation if I were paid to do so; it isn't a volunteer effort</span></label></li>


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


</ul></div></div></div><div style="font-size:13px;background-color:rgb(247,247,247);font-family:sans-serif,sans-serif"><div dir="ltr" style="margin:12px 0px"><div style="margin-bottom:1.5em">
<label><div style="font-weight:bold">Generally does your team value documentation for contributors? For deployers? For end-users?</div><div dir="ltr" style="margin:0.1em 0px 0.25em;color:rgb(102,102,102)">
</div></label><ul style="list-style:none;padding:0px;margin:0.5em 0px 0px"><li style="margin:0px;line-height:1.3em;padding-bottom:0.5em"><label><span><input type="checkbox" name="entry.212924700" value="Yes, of course" style="vertical-align:middle"></span> <span>Yes, of course</span></label></li>


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


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


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


</ul></div></div></div></div></div>
</blockquote></div><br></div>