<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">
</head>
<body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; ">
As a side-effect of working on the community training docs, we felt a simple, very specific version of the docs how to was required. It seems likely that we will incorporate the docs how to into the training itself. The idea being that learning to bug fix the
docs is a good first step before learning to bug fix code. It will also make new devs first learn the docs before jumping into one of the projects.
<div><br>
</div>
<div>So for question 7, i'd like to figure out how to integrate the doc boot camp material and sessions into the training we are putting together. It would be inspired!<br>
<div>
<div apple-content-edited="true">
<div style="font-size: medium; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; ">
<div style="color: rgb(0, 0, 0); font-family: Calibri, sans-serif; font-size: 14px; ">
<span class="Apple-style-span" style="font-size: 13px; "><span style="font-family: Calibri; font-weight: bold; color: gray; margin: 0px; padding: 0px; "><br class="Apple-interchange-newline">
<br>
</span></span></div>
<div style="color: rgb(0, 0, 0); font-family: Calibri, sans-serif; font-size: 14px; ">
<span class="Apple-style-span" style="font-size: 13px; "><span style="font-family: Calibri; font-weight: bold; color: gray; margin: 0px; padding: 0px; ">Sean Roberts</span></span><span class="Apple-style-span" style="font-size: 13px; "><br>
</span><span class="Apple-style-span" style="font-size: 13px; "><span style="color: gray; font-family: Calibri; margin: 0px; padding: 0px; ">Infrastructure Strategy</span></span></div>
<div style="font-size: 14px; "><span class="Apple-style-span" style="font-size: 13px; "><font color="#808080" face="Calibri"><a href="mailto:seanrob@yahoo-inc.com">seanrob@yahoo-inc.com</a> </font></span><span style="color: gray; font-family: Calibri; font-size: 13px; ">(925)
980-4729</span></div>
</div>
</div>
<br>
<div>
<div>On Jul 8, 2013, at 11:58 AM, Anne Gentle <<a href="mailto:anne@openstack.org">anne@openstack.org</a>></div>
<div> wrote:</div>
<br class="Apple-interchange-newline">
<blockquote type="cite">
<div dir="ltr">No responses here? I'd love to hear your thoughts. </div>
<div class="gmail_extra"><br>
<br>
<div class="gmail_quote">On Thu, Jun 27, 2013 at 2:39 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">
<p>Hi all -</p>
<p>With the new "programs" coming to OpenStack, some documentation will need to be delivered on the same day as the release. We also now have 10 core/integrated projects with 2 more in incubation. Currently the documentation that is delivered on the same day
as the release is the contributor docs, maintained by the Python devs (Sphinx/RST) and stored with the code. We have separate repos for API docs and operator docs, but the review processes are the same as the code. As you can imagine, I'm looking for ideas
for this brave new world.<br>
</p>
<p>Specifically, here are some questions I want to ask all of you for inspiration and ideas:</p>
<ol>
<li>What's the most important lesson you've learn about motivating developers to write user documentation? Who taught it to you and how?
</li><li>What's the most difficult issue around documentation that you see over and over again in open source projects? How do people avoid it or fix it when it happens to them?
</li><li>With the different projects under the OpenStack umbrella, how much consistency would you expect to see, project-to-project?
</li><li>As a reader, would you prioritize project docs over overarching docs or vice-versa? Why?
</li><li>As a project maintainer, which docs would you value more highly, combined solutions docs or docs specific and detailed for your project? Why?
</li><li>Do you think people want in-person training sessions about how to write OpenStack docs? We're working on a doc boot camp with a day of teaching and a day of doing, what do you think is an important planning part of that? Who specifically would you invite?
</li><li>How important is "official" to you when it comes to project documentation, such as Python or Django? What editorial/review processes are in place to ensure a doc is considered "official?"
</li><li>What makes people in a community excited about documentation? Successful outcomes? Camaraderie? Speaking from a point of authority?
</li></ol>
<p>Thanks all for your input — looking forward to responses and being inspired while I drive cross-country.</p>
<span class="HOEnZb"><font color="#888888">
<p>Anne<br>
</p>
</font></span></div>
</blockquote>
</div>
<br>
</div>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs<br>
</blockquote>
</div>
<br>
</div>
</div>
</body>
</html>