<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Tue, Jul 1, 2014 at 12:13 AM, Frans Thamura <span dir="ltr"><<a href="mailto:frans@meruvian.org" target="_blank">frans@meruvian.org</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">On Tue, Jul 1, 2014 at 11:58 AM, Sean Roberts <<a href="mailto:seanrob@yahoo-inc.com">seanrob@yahoo-inc.com</a>> wrote:<br>


> We use xi:include statements during the training guides build. The training materials are built with the install guides.<br>
<br>
hi sean<br>
<br>
can explain more about this?<br>
<br>
i still dont get xi:include relation between role based training guide<br>
vs step-by-stey based installation guide<br>
<br></blockquote><div><br></div><div>Hi Frans -</div><div><br></div><div>With our current system we have the ability to directly include parts from any other XML-based guide. That's what Sean means for xi:include, it's a technical term for content reuse.</div>

<div><br></div><div>So what the training guides often do is pick pieces from a given guide and put them together in the order they want. </div><div><br></div><div>Ideally, the training manual follows the installation guide exactly.</div>

<div><br></div><div>While your "keep adding nodes" suggestion is quite good, I don't see the work to test and write step-by-step guides paying off... there would be tradeoffs. For now, the direction we are taking with the install guides is to document a few "happy paths" such as:</div>

<div><br></div><div>Compute with nova-network</div><div>Compute with OpenStack Networking (neutron)</div><div>Compute with additional block storage</div><div>Object Storage with Identity (no Dashboard) </div><div>Compute with Orchestration</div>

<div>Compute with Databases</div><div>Compute with Telemetry</div><div><br></div><div>Considering the wide breadth of installing all the OpenStack projects, I think this is the course we have to continue to take. </div><div>

<br></div><div><div>We would like to continue to explain more architectures, but I don't believe the installation guide is quite the right place to do this. Instead, next week a group of authors are going to do a book sprint to describe the many ways you can configure OpenStack to meet different use cases. </div>

</div><div><br></div><div>Please follow the Design and Architecture sprint closely as I think it may be a deliverable you'd like to have as a companion for training classes.</div><div><br></div><div>Anne</div><div><br>

</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
F<br>
<br>
<br>
><br>
> ~sean<br>
<div class=""><div class="h5">><br>
>> On Jun 30, 2014, at 9:54 PM, "Frans Thamura" <<a href="mailto:frans@meruvian.org">frans@meruvian.org</a>> wrote:<br>
>><br>
>> hi all<br>
>><br>
>> wanna to know, the installation guide and training guide structure,<br>
>><br>
>> can anyone explain relation of the content<br>
>><br>
>> in my mind training guide - installation also part of it.<br>
>><br>
>> and we have installation content in <a href="http://doc.openstack.org" target="_blank">doc.openstack.org</a>.<br>
>><br>
>> and we know there are several guide inside based on role.<br>
>><br>
>> thx<br>
>><br>
>> F<br>
>><br>
>> _______________________________________________<br>
>> Openstack-docs mailing list<br>
>> <a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
>> <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><br>
<br>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
<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><br>
</div></div></blockquote></div><br></div></div>