<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
</head>
<body dir="auto">
<div>We are almost ready to start posting new training material. I assumed I should I wait until the blueprint is approved... Or not?<br>
<br>
~sean</div>
<div><br>
On Jul 3, 2013, at 5:22 AM, "Nick Chase" <<a href="mailto:nchase@mirantis.com">nchase@mirantis.com</a>> wrote:<br>
<br>
</div>
<blockquote type="cite">
<div>
<p dir="ltr">A big part of the plan is that modularity so you should be fine , but I will definitely have a look at the training manuals and try not to break anything.<br>
</p>
<div class="gmail_quote">On Jul 2, 2013 7:01 PM, "Sean Roberts" <<a href="mailto:seanrob@yahoo-inc.com">seanrob@yahoo-inc.com</a>> wrote:<br type="attribution">
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="auto">
<div><span>We are working on user group driven training material that will need to be horizontal to at least the administrator guides and pull shared material from all in the repo. </span><a href="https://blueprints.launchpad.net/openstack-manuals/+spec/training-manuals" target="_blank">https://blueprints.launchpad.net/openstack-manuals/+spec/training-manuals</a></div>
<div><span>Does this plan align with the different administrator guides below? </span></div>
<div><br>
~sean</div>
<div><br>
On Jul 1, 2013, at 6:13 PM, "Nicholas Chase" <<a href="mailto:nchase@mirantis.com" target="_blank">nchase@mirantis.com</a>> wrote:<br>
<br>
</div>
<blockquote type="cite">
<div><span></span><br>
<span></span><br>
<span>On 7/1/2013 8:59 PM, Tom Fifield wrote:</span><br>
<blockquote type="cite"><span>Welcome Summer! It's great to have you.</span><br>
</blockquote>
<blockquote type="cite"><span></span><br>
</blockquote>
<blockquote type="cite"><span>So, up until 30 seconds ago when I checked the wiki, I thought I had a</span><br>
</blockquote>
<blockquote type="cite"><span>good idea of our restructure, which is laid out as:</span><br>
</blockquote>
<blockquote type="cite"><span><a href="https://wiki.openstack.org/wiki/Blueprint-restructure-documentation" target="_blank">https://wiki.openstack.org/wiki/Blueprint-restructure-documentation</a></span><br>
</blockquote>
<blockquote type="cite"><span></span><br>
</blockquote>
<blockquote type="cite"><span>On of the points of the restructure was to do away with the current</span><br>
</blockquote>
<blockquote type="cite"><span>administration guide (eg</span><br>
</blockquote>
<blockquote type="cite"><span><a href="http://docs.openstack.org/trunk/openstack-compute/admin" target="_blank">http://docs.openstack.org/trunk/openstack-compute/admin</a>), because</span><br>
</blockquote>
<blockquote type="cite"><span>operators found it "exhaustive to the point of being past useless"[1].</span><br>
</blockquote>
<blockquote type="cite"><span></span><br>
</blockquote>
<blockquote type="cite"><span>The aim that I remember was to create a Configuration Reference, which</span><br>
</blockquote>
<blockquote type="cite"><span>would have much shorter introductions to each of the features in</span><br>
</blockquote>
<blockquote type="cite"><span>OpenStack, followed by a table of their configuration options</span><br>
</blockquote>
<blockquote type="cite"><span>automatically generated from code.</span><br>
</blockquote>
<blockquote type="cite"><span></span><br>
</blockquote>
<blockquote type="cite"><span>This was to be accompanied by a User guide, one for end-users of the</span><br>
</blockquote>
<blockquote type="cite"><span>cloud, and one for Administrators of the cloud (wich much shared content).</span><br>
</blockquote>
<blockquote type="cite"><span></span><br>
</blockquote>
<blockquote type="cite"><span>However, I now see that "Administration Guide" has been added to the</span><br>
</blockquote>
<blockquote type="cite"><span>wiki, which has caused me great confusion :)</span><br>
</blockquote>
<span></span><br>
<span>Well, there's actually TWO blueprints I'm working on. One is for the admin guide, and the other is for a plan to let people easily break down the admin guide into more manageable pieces in an automated way, so that it doesn't have to be "exhaustive to
the point of being past useless". :)</span><br>
<span></span><br>
<span>PLUS, the plan is for the guide that we DO produce to have the configuration information stripped out and included in the Configuration reference as planned.</span><br>
<span></span><br>
<span>All of that said, I definitely see the confusion between the "Admin User's Guide" and the "Administration Guide", which is part of what has been taking me a little bit longer ...</span><br>
<span></span><br>
<span>I think I need to look at this again.</span><br>
<span></span><br>
<span>---- Nick</span><br>
<span></span><br>
<blockquote type="cite"><span>Regards,</span><br>
</blockquote>
<blockquote type="cite"><span></span><br>
</blockquote>
<blockquote type="cite"><span></span><br>
</blockquote>
<blockquote type="cite"><span>Tom</span><br>
</blockquote>
<blockquote type="cite"><span></span><br>
</blockquote>
<blockquote type="cite"><span>[1]<a href="https://bugs.launchpad.net/openstack-manuals/+bug/1110137" target="_blank">https://bugs.launchpad.net/openstack-manuals/+bug/1110137</a></span><br>
</blockquote>
<blockquote type="cite"><span></span><br>
</blockquote>
<blockquote type="cite"><span>On 02/07/13 10:45, Nicholas Chase wrote:</span><br>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span></span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span>On 7/1/2013 8:06 PM, Summer Long wrote:</span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span>Hi Anne,</span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span>I've been working on OpenStack docs over at Red Hat, and would like to</span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span>help with the OS Admin Guide.</span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span>Can you tell me where I can contribute to its design? Steve Gordon tells</span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span>me that the intent is to consolidate the various component guides?</span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span></span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span>Hi, Summer --</span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span></span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span>I've actually been pretty quiet here, but I'm currently working on a</span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span>plan for this consolidation -- blueprint to be up shortly, I promise! --</span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span>would you like to get together sometime this week to chat about how we</span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span>might work together on this?</span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span></span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span>I'm new to working with Open Source docs (previously worked with</span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span>proprietary software houses), so am pretty excited about stepping over</span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span>to the light side!</span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span></span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span>I can't speak for anyone else, but for me, nice to have you here. :)</span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span></span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span>---- Nick</span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span></span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span>thanks,</span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span>Summer</span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span></span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span></span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span>Summer Long</span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span>OpenStack Documentation</span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span>Engineering Content Services</span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span></span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span>Red Hat Asia Pacific</span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span>Brisbane, Australia</span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span><a href="mailto:slong@redhat.com" target="_blank">slong@redhat.com</a> <<a href="mailto:slong@redhat.com" target="_blank">mailto:slong@redhat.com</a>></span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span></span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span></span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span></span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span></span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span>_______________________________________________</span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span>Openstack-docs mailing list</span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span><a href="mailto:Openstack-docs@lists.openstack.org" target="_blank">Openstack-docs@lists.openstack.org</a></span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span><a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a></span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite">
<blockquote type="cite"><span></span><br>
</blockquote>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span></span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span>_______________________________________________</span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span>Openstack-docs mailing list</span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span><a href="mailto:Openstack-docs@lists.openstack.org" target="_blank">Openstack-docs@lists.openstack.org</a></span><br>
</blockquote>
</blockquote>
<blockquote type="cite">
<blockquote type="cite"><span><a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a></span><br>
</blockquote>
</blockquote>
<blockquote type="cite"><span></span><br>
</blockquote>
<blockquote type="cite"><span></span><br>
</blockquote>
<blockquote type="cite"><span>_______________________________________________</span><br>
</blockquote>
<blockquote type="cite"><span>Openstack-docs mailing list</span><br>
</blockquote>
<blockquote type="cite"><span><a href="mailto:Openstack-docs@lists.openstack.org" target="_blank">Openstack-docs@lists.openstack.org</a></span><br>
</blockquote>
<blockquote type="cite"><span><a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a></span><br>
</blockquote>
<blockquote type="cite"><span></span><br>
</blockquote>
<span></span><br>
<span>_______________________________________________</span><br>
<span>Openstack-docs mailing list</span><br>
<span><a href="mailto:Openstack-docs@lists.openstack.org" target="_blank">Openstack-docs@lists.openstack.org</a></span><br>
<span><a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a></span><br>
</div>
</blockquote>
</div>
</blockquote>
</div>
</div>
</blockquote>
</body>
</html>