<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Tue, Jul 1, 2014 at 12:34 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:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">will try to follow the sprint...<br>
<br>
i like the role based training guide, and have small experience here,<br>
related to install, using, administring of the system, and<br>
installation guide is not match that.<br>
<br>
i wish can link the step by step instruction that we use here to role<br>
model of training guide. associate, architect etc.<br>
<br>
i feel that there are a matrix approach if we can link all of these<br>
and create combination of implementation, sound interesting.<br>
<br>
<br>
still keep learning how the docs team develop docs<br></blockquote><div><br></div><div>The process has been pretty stable; the scope increases over time. </div><div><br></div><div>I'd be happy to get on a phone call with you if you'd like a deeper dive. </div>

<div><br></div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
<br>
F<br>
--<br>
Frans Thamura (曽志胜)<br>
Shadow Master and Lead Investor<br>
Meruvian.<br>
Integrated Hypermedia Java Solution Provider.<br>
<br>
Mobile: <a href="tel:%2B628557888699" value="+628557888699">+628557888699</a><br>
Blog: <a href="http://blogs.mervpolis.com/roller/flatburger" target="_blank">http://blogs.mervpolis.com/roller/flatburger</a> (id)<br>
<br>
FB: <a href="http://www.facebook.com/meruvian" target="_blank">http://www.facebook.com/meruvian</a><br>
TW: <a href="http://www.twitter.com/meruvian" target="_blank">http://www.twitter.com/meruvian</a> / @meruvian<br>
Website: <a href="http://www.meruvian.org" target="_blank">http://www.meruvian.org</a><br>
<br>
"We grow because we share the same belief."<br>
<div class="HOEnZb"><div class="h5"><br>
<br>
On Tue, Jul 1, 2014 at 12:22 PM, Anne Gentle <<a href="mailto:anne@openstack.org">anne@openstack.org</a>> wrote:<br>
><br>
><br>
><br>
> On Tue, Jul 1, 2014 at 12:13 AM, Frans Thamura <<a href="mailto:frans@meruvian.org">frans@meruvian.org</a>> wrote:<br>
>><br>
>> On Tue, Jul 1, 2014 at 11:58 AM, Sean Roberts <<a href="mailto:seanrob@yahoo-inc.com">seanrob@yahoo-inc.com</a>><br>
>> wrote:<br>
>> > We use xi:include statements during the training guides build. The<br>
>> > 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>
><br>
> Hi Frans -<br>
><br>
> With our current system we have the ability to directly include parts from<br>
> any other XML-based guide. That's what Sean means for xi:include, it's a<br>
> technical term for content reuse.<br>
><br>
> So what the training guides often do is pick pieces from a given guide and<br>
> put them together in the order they want.<br>
><br>
> Ideally, the training manual follows the installation guide exactly.<br>
><br>
> While your "keep adding nodes" suggestion is quite good, I don't see the<br>
> work to test and write step-by-step guides paying off... there would be<br>
> tradeoffs. For now, the direction we are taking with the install guides is<br>
> to document a few "happy paths" such as:<br>
><br>
> Compute with nova-network<br>
> Compute with OpenStack Networking (neutron)<br>
> Compute with additional block storage<br>
> Object Storage with Identity (no Dashboard)<br>
> Compute with Orchestration<br>
> Compute with Databases<br>
> Compute with Telemetry<br>
><br>
> Considering the wide breadth of installing all the OpenStack projects, I<br>
> think this is the course we have to continue to take.<br>
><br>
> We would like to continue to explain more architectures, but I don't believe<br>
> the installation guide is quite the right place to do this. Instead, next<br>
> week a group of authors are going to do a book sprint to describe the many<br>
> ways you can configure OpenStack to meet different use cases.<br>
><br>
> Please follow the Design and Architecture sprint closely as I think it may<br>
> be a deliverable you'd like to have as a companion for training classes.<br>
><br>
> Anne<br>
><br>
><br>
>><br>
>> F<br>
>><br>
>><br>
>> ><br>
>> > ~sean<br>
>> ><br>
>> >> On Jun 30, 2014, at 9:54 PM, "Frans Thamura" <<a href="mailto:frans@meruvian.org">frans@meruvian.org</a>><br>
>> >> 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>
><br>
><br>
</div></div></blockquote></div><br></div></div>