<div dir="ltr">Andreas,<div><br></div><div>I consider the API documentation and installation guide rather complex for initial content to move to project repositories and evaluate the results. However, we're seeing rather strong adoption of moving API documentation which I think predicts adoption of moving operator/user documentation more than the installation guide. Regardless of outcome, the API documentation caters to a smaller audience with at least some knowledge of OpenStack and/or development experience, thus having less impact on adoption of OpenStack. On the other hand, the installation guide is extremely popular and caters to a larger audience with little (if any) prior knowledge of OpenStack that expects the procedures to work with minimal frustration. Victimizing this audience hinders adoption of OpenStack and may cast the wrong impression of moving content into project repositories.</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Jul 11, 2016 at 3:52 PM, Michael Johnson <span dir="ltr"><<a href="mailto:johnsomor@gmail.com" target="_blank">johnsomor@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">I support putting infrastructure in place to allow the project<br>
documentation to be in the project's repository.  We had problems in<br>
the Mitaka release with documentation getting deleted without the<br>
project team knowing it was happening until users were asking us where<br>
the documentation was located.<br>
<br>
Having it in the repository makes it easier to review that the<br>
required documentation updates are being made and gives the project<br>
team visibility to changes in the documentation.<br>
<span class="HOEnZb"><font color="#888888"><br>
Michael<br>
</font></span><div class="HOEnZb"><div class="h5"><br>
<br>
On Sun, Jul 10, 2016 at 10:31 PM, Andreas Jaeger <<a href="mailto:aj@suse.com">aj@suse.com</a>> wrote:<br>
><br>
> With Install Guide and API references, we had specific problems to<br>
> solve. Which ones do you see exactly with other guides?<br>
><br>
> Also, before we discuss moving further documentation around, I'd like to<br>
> see first how the API references and Install guides work out and what we<br>
> need to improve there - before discussing next steps,<br>
><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>
> __________________________________________________________________________<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>
<br>
__________________________________________________________________________<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></div>