<div dir="ltr">On Mon, Jul 8, 2013 at 3:36 PM, Steve Gordon <span dir="ltr"><<a href="mailto:sgordon@redhat.com" target="_blank">sgordon@redhat.com</a>></span> wrote:<br><div class="gmail_extra"><div class="gmail_quote">
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im">----- Original Message -----<br>
> From: "Anne Gentle" <<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a>><br>
> To: "Lorin Hochstein" <<a href="mailto:lorin@nimbisservices.com">lorin@nimbisservices.com</a>><br>
> Cc: <a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a><br>
> Sent: Monday, July 8, 2013 11:03:05 AM<br>
> Subject: Re: [Openstack-docs] Linking to external install guides<br>
><br>
> So, for the last few releases, I would update<br>
> <a href="http://www.openstack.org/software/start/" target="_blank">http://www.openstack.org/software/start/</a> with links to the downstream<br>
> deployment documentation. It was natural at the time.<br>
><br>
> What has changed as of last week is that documentation is now an official<br>
> "Program" and we'll need to propose the goals for the documentation and<br>
> make a scope for release docs. To me, this change means we should be more<br>
> tight and targeted with our install docs as they'll be part of the<br>
> integrated release.<br>
<br>
</div>Downstream deployment materials tend to cover arguably more streamlined approaches to deployment, such as Foreman, PackStack, Ansible, JuJu, etc. The flip side however is these deployment methods are not considered part of OpenStack itself and may not in fact be ready to deploy a new release on day dot. These approaches also don't necessarily have 1:1 equivalents across distributions.<br>

<br>
For these reasons my feeling is the documentation "program" should be concentrated on delivering accurate manual installation steps at release time in a consolidated installation guide as suggested in the restructure blueprint [1]. I don't think however this precludes also linking the distribution specific materials somewhere as they become available, it just wouldn't be a blocker to the integrated release?<br>

<br>
-Steve<br>
<br>
[1] <a href="https://wiki.openstack.org/wiki/Blueprint-restructure-documentation" target="_blank">https://wiki.openstack.org/wiki/Blueprint-restructure-documentation</a><br>
</blockquote></div><div class="gmail_extra"><br></div><div class="gmail_extra"><br></div>At the last design summit, we talked about the doc team no longer maintaining any install documentation at all going forward, leaving that entirely to downstream projects. I really do think that's the way we should go. I'm hesitant to maintain docs on a fully manual install (i.e., from source tarballs), since we really don't want people to do that.</div>
<div class="gmail_extra"><br></div><div class="gmail_extra">It means that documentation on how to do an install won't exist until the downstream projects write these up, but since we recommend installing from downstream packages, I think that's unavoidable. Since we're seeing a lot more support for OpenStack downstream these days, I think those projects have more of an incentive to get their packages and docs ready ASAP after a release.</div>
<div class="gmail_extra"><br></div><div class="gmail_extra" style>Lorin</div><div class="gmail_extra"><br></div><div class="gmail_extra">-- <br><div dir="ltr">Lorin Hochstein<br><div>Lead Architect - Cloud Services</div><div>
Nimbis Services, Inc.</div><div><a href="http://www.nimbisservices.com" target="_blank">www.nimbisservices.com</a></div></div>
</div></div>