Hi all - <br>I've been studying the existing web properties and want to provide some predictability in the documentation - what you can expect to find where. For tech docs, I see three potential 
locations. <br><ol><li>Sphinx (<a href="http://nova.openstack.org/" target="_blank">nova.openstack.org</a> and <a href="http://swift.openstack.org/" target="_blank">swift.openstack.org</a>)<br>
</li><li>Wiki (<a href="http://wiki.openstack.org/" target="_blank">wiki.openstack.org</a>)<br></li><li>Website
 (<a href="http://openstack.org/" target="_blank">openstack.org</a>)<br></li></ol>Based on the existing architecture, I would propose: <br><ul><li>Preserve <a href="http://swift.openstack.org/" target="_blank">swift.openstack.org</a> and <a href="http://nova.openstack.org/" target="_blank">nova.openstack.org</a>
 for developer <span class="il">documentation and conceptual information. </span></li><li> Point to the developer docs with links on the wiki but also write a lot of tutorials on the wiki.</li><li>Set up community docs with constant updates on the wiki.</li>

<li>Provide official docs with a release number assigned as releases revise on the <a href="http://openstack.org/" target="_blank">openstack.org</a>
 site. </li></ul>I'm thinking these assignments give us good, flexible options because we then cater to specific 
audiences - <a href="http://openstack.org/" target="_blank">openstack.org</a>
 site for bizdev/users/deployers, <a href="http://nova.openstack.org">nova.openstack.org</a> 
and <a href="http://swift.openstack.org">swift.openstack.org</a> for developers, and <a href="http://wiki.openstack.org">wiki.openstack.org</a> for tutorials as well as pointers
 to other locations and project planning. <br><br>I'd love your ideas and feedback on this approach - either write back on this thread or find me on IRC, or I can set up a call. <br>



<br>I also have to say, now is the best time to write your way to understanding - we have fresh perspectives and a code freeze, an ideal combo. If you're not feeling particularly creative or you don't want to start with a fresh page, start with <a href="http://wiki.openstack.org/Documentation">http://wiki.openstack.org/Documentation</a>  which offers an outline and links to pages. <br>


<br>Last but not least, I've set up an OpenStack-<span class="il">doc</span> group (<a href="https://launchpad.net/%7Eopenstack-doc" target="_blank">link</a>) so we can meet regularly
 to coordinate <span class="il">doc</span> efforts. I need like-minded community doc 
peeps to bounce these ideas off of. :) Thanks to Nachi Ueno for joining - contact me off-list with your mailing address and I'll send you a t-shirt. Woo!<br><br>Thanks, <br>Anne<br>
<div style="margin: 2em 0pt;" name="sig_d4a6b6619e"><span style="color: rgb(136, 136, 136);"><span style="color: rgb(136, 136, 136);">
<div><strong>Anne Gentle</strong>
<br>
<a href="mailto:anne@openstack.org" target="_blank">anne@openstack.org</a>
<br>
OpenStack Content Stacker
<br>
<div><a href="../../" target="_blank">my blog</a> | <a href="http://xmlpress.net/publications/conversation-community/" target="_blank">my book</a> | <a href="http://www.linkedin.com/in/annegentle" target="_blank">LinkedIn</a> | <a href="http://del.icio.us/annegentle" target="_blank">Delicious</a> |  <a href="http://twitter.com/annegentle" target="_blank">Twitter</a></div>


</div>
</span></span></div>