<div dir="ltr"><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Apr 4, 2016 at 1:41 PM, Andreas Jaeger <span dir="ltr"><<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="HOEnZb"><div class="h5">On 04/04/2016 12:12 PM, Thierry Carrez wrote:<br>
> Doug Hellmann wrote:<br>
>>> [...]<br>
>>> We would love to add all sufficiently mature projects to the<br>
>>> installation<br>
>>> guide because it increases visibility and adoption by operators, but we<br>
>>> lack resources to develop a source installation mechanism that<br>
>>> retains as<br>
>>> much simplicity as possible for our audience.<br>
>><br>
>> I think it would be a big mistake to try to create one guide for<br>
>> installing all OpenStack projects. As you say, testing what we have<br>
>> now is already a monumental task and impedes your ability to make<br>
>> changes.  Adding more projects, with ever more dependencies and<br>
>> configuration issues to the work the same team is doing would bury<br>
>> the current documentation team. So I think focusing on the DefCore<br>
>> list, or even a smaller list of projects with tight installation<br>
>> integration requirements, makes sense for the team currently producing<br>
>> the installation guide.<br>
><br>
> Yes, the base install guide should ideally serve as a reference to reach<br>
> that first step where you have all the underlying services (MySQL,<br>
> Rabbit) and a base set of functionality (starterkit:compute ?) installed<br>
> and working. That is where we need high-quality, proactively-checked,<br>
> easy to understand content.<br>
><br>
> Then additional guides (ideally produced by each project team with<br>
> tooling and mentoring from the docs team) can pick up from that base<br>
> first step, assuming their users have completed that first step<br>
> successfully.<br>
><br>
<br>
</div></div>Fully agreed.<br>
<br>
I just wrote a first draft spec for all of this and look forward to reviews.<br>
<br>
I'll enhance some more tomorrow, might copy a bit from above (saw this<br>
too late).<br>
<br>
<a href="https://review.openstack.org/301284" rel="noreferrer" target="_blank">https://review.openstack.org/301284</a><br>
<span class="im HOEnZb"><br>
Andreas<br>
--<br>
 Andreas Jaeger aj@{<a href="http://suse.com" rel="noreferrer" target="_blank">suse.com</a>,<a href="http://opensuse.org" rel="noreferrer" target="_blank">opensuse.org</a>} Twitter/Identica: jaegerandi<br>
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
   GF: Felix Imendörffer, Jane Smithard, Graham Norton,<br>
       HRB 21284 (AG Nürnberg)<br>
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126<br>
<br>
<br>
</span><div class="HOEnZb"><div class="h5">__________________________________________________________________________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</div></div></blockquote></div><br>I commented on the review, but is an alternative solution to appropriately rename the Install Guide to something like "OpenStack Proof of Concept Guide" or "OpenStack Starter Kit Guide" and then create the centralized docs.o.o/install-guides that references both project-specific and deployment-project install guides? </div><div class="gmail_extra"><br></div><div class="gmail_extra">These guides could then offer more flexibility in install options and advice.<br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr">Kenny Johnston | freenode:kencjohnston | @kencjohnston</div></div>
</div></div>