In short, I agree with Tom Fifield. I'm planning to provide a more thorough response after the Thanksgiving holiday weekend.<br><br><div class="gmail_quote">On Thu Nov 27 2014 at 5:00:52 AM Thomas Goirand <<a href="mailto:zigo@debian.org">zigo@debian.org</a>> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On 11/27/2014 11:16 AM, Tom Fifield wrote:<br>
> Thomas,<br>
><br>
> As you know, I am in awe of the amount of effort you put in in packaging<br>
> and feel you are under-appreciated :) I'm sorry to trim your email so<br>
> much, but I just wanted to address this one point. Hopefully the others<br>
> will reply more fully (which you deserve, for such a detailed email).<br>
><br>
> On 27/11/14 07:41, Thomas Goirand wrote:<br>
>> See this:<br>
>><br>
>> <a href="http://docs.openstack.org/juno/install-guide/install/apt-debian/content/glance-install.html" target="_blank">http://docs.openstack.org/<u></u>juno/install-guide/install/<u></u>apt-debian/content/glance-<u></u>install.html</a><br>
>><br>
>> Then see this:<br>
>> <a href="http://docs.openstack.org/juno/install-guide/install/apt/content/glance-install.html" target="_blank">http://docs.openstack.org/<u></u>juno/install-guide/install/<u></u>apt/content/glance-install.<u></u>html</a><br>
>><br>
>> Then tell me which of the 2 is the most easy, and which one newbies will<br>
>> want to read.<br>
><br>
> I think there's an assumption here which is worth commenting on.<br>
><br>
> The purpose of the install guide on <a href="http://docs.openstack.org" target="_blank">docs.openstack.org</a> is actually not<br>
> to make the 'most easy' way to install OpenStack.<br>
><br>
> The purpose of the install guide on <a href="http://docs.openstack.org" target="_blank">docs.openstack.org</a> is to get a<br>
> reasonably-good practice deployment up while educating the reader just<br>
> enough on how the underlying things work that they can then move on to<br>
> use more advanced tools (think puppet, chef, et al) in conjunction with<br>
> the other documents.<br>
><br>
> For example's sake, one 'most easy' way to install OpenStack that quite<br>
> a lot of people use is DevStack.<br>
><br>
> What is needed in the install guide on <a href="http://docs.openstack.org" target="_blank">docs.openstack.org</a> is a<br>
> mid-point, that takes them from that "hand-holding" way to being able to<br>
> use automation to do an install.<br>
><br>
> Regards,<br>
><br>
> Tom<br>
<br>
Hi Tom,<br>
<br>
Thanks for your nice words.<br>
<br>
One important thing here. For each and every service we're documenting,<br>
there's the same exact explanations on how to set the<br>
keystone_authtoken, the API endpoints, the rabbitMQ credentials and the<br>
MySQL database. In the Ubuntu doc, this feels like there's a lot of<br>
redundancy.<br>
<br>
We discussed this during the Paris summit, and the issue here, is that<br>
we want the readers to be able to do cut/past, so it's not really<br>
possible to have a global chapter that would talk about the above 4<br>
subjects. But otherwise, we all felt it would have been better with a<br>
single chapter talking about it.<br>
<br>
In Debian, there's such chapter, which is the Debconf chapter. In it, I<br>
have documented the directives which are edited by the automation. So it<br>
is still possible for someone who wishes to use puppet/chef/$you-name-it<br>
to do so by reading the install-guide, as the information is also there<br>
for Debian, and because Debconf supports manual edition of directives.<br>
<br>
So I don't think we have an issue here, and we're still on the mid-point<br>
that you're talking about.<br>
<br>
Your thoughts?<br>
<br>
Cheers,<br>
<br>
Thomas Goirand (zigo)<br>
<br>
<br>
______________________________<u></u>_________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">OpenStack-docs@lists.<u></u>openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/<u></u>cgi-bin/mailman/listinfo/<u></u>openstack-docs</a><br>
</blockquote></div>