<div dir="ltr">Hey Jeremy and Lana, <div><br></div><div>Thanks for the quick reply. I found developer's documentation. I wonder if removing the word "Python" will help. Also, I wonder if moving developer documentation under it's own category will help to increase visibility of this documentation, because the Contributor Guides category does not always reflect the purpose of the guides. Many of the guides that I've seen under the Developer Guides category not only describe how to contribute to the project, but also reveal how to install, configure, use with other components and so on. </div><div><br></div><div>As for the installation guides discussion, I think it's a very good initiative and I'm happy that it's happening =). I also think this should have a little broader scope and include all user documentation, as, for example, Fuel has not only an Installation guide, but also a User guide that we would like to publish at <a href="http://docs.openstack.org">docs.openstack.org</a> from our own repository. I think that other projects have similar issues as right now many of them just publish both developer and user documentation at <a href="http://docs.openstack.org/developer">docs.openstack.org/developer</a>. And yes, I agree it will help to keep bugs under respective project queues.</div><div class="gmail_extra"><br></div><div class="gmail_extra">Thanks,</div><div class="gmail_extra">Svetlana</div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Apr 14, 2016 at 1:28 PM, Lana Brindley <span dir="ltr"><<a href="mailto:openstack@lanabrindley.com" target="_blank">openstack@lanabrindley.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On 15/04/16 04:34, Svetlana Karslioglu wrote:<br>
> Hi Lana and all,<br>
><br>
> I have the following questions:<br>
><br>
</span>>  1. How users can find the documentation published at <a href="http://docs.openstack.org/developer" rel="noreferrer" target="_blank">docs.openstack.org/developer</a> <<a href="http://docs.openstack.org/developer" rel="noreferrer" target="_blank">http://docs.openstack.org/developer</a>> from the <a href="http://docs.openstack.org" rel="noreferrer" target="_blank">docs.openstack.org</a> <<a href="http://docs.openstack.org" rel="noreferrer" target="_blank">http://docs.openstack.org</a>> page? I couldn't find a way to do it. It looks like unless you know the link to <a href="http://docs.openstacl.org/developer" rel="noreferrer" target="_blank">docs.openstacl.org/developer</a> <<a href="http://docs.openstacl.org/developer" rel="noreferrer" target="_blank">http://docs.openstacl.org/developer</a>>, you cannot find this documentation. Shouldn't the link to developer's documentation be added to <a href="http://docs.openstack.org" rel="noreferrer" target="_blank">docs.openstack.org</a> <<a href="http://docs.openstack.org" rel="noreferrer" target="_blank">http://docs.openstack.org</a>>?<br>
<br>
Jeremy is correct, it's linked under Python Developer Documentation, but I agree that is a little obfuscated. What would you prefer to see here?<br>
<br>
>  2. How to access previous versions of documentation published at <a href="http://docs.openstack.org/developer" rel="noreferrer" target="_blank">docs.openstack.org/developer</a> <<a href="http://docs.openstack.org/developer" rel="noreferrer" target="_blank">http://docs.openstack.org/developer</a>>? I tried the following and it did not work:<br>
>       * <a href="http://docs.openstack.org/developer/liberty" rel="noreferrer" target="_blank">http://docs.openstack.org/developer/liberty</a><br>
>       * <a href="http://docs.openstack.org/liberty/developer" rel="noreferrer" target="_blank">http://docs.openstack.org/liberty/developer</a><br>
<br>
The documentation on /developer is usually continuously integrated, so there are no versioned docs. Different projects may handle this in different ways that I'm not aware of, though.<br>
<br>
>  3. Some of the documentation that we published at <a href="http://docs.openstack.org/developer/fuel-docs" rel="noreferrer" target="_blank">docs.openstack.org/developer/fuel-docs</a> <<a href="http://docs.openstack.org/developer/fuel-docs" rel="noreferrer" target="_blank">http://docs.openstack.org/developer/fuel-docs</a>> is actually users documentation (Fuel Installation Guide, Fuel User Guide).We would like to publish this documentation separately from the developer documentation and add a link to this documentation at <a href="http://docs.openstack.org" rel="noreferrer" target="_blank">docs.openstack.org</a> <<a href="http://docs.openstack.org" rel="noreferrer" target="_blank">http://docs.openstack.org</a>>? We would like the documentation to continue to live in the fuel-docs repository and we will continue to support it. Please advise on the process here.<br>
<br>
At the moment, we don't have the infrastructure to support docs at any URL other than /developer. However, the idea of changing this is been floated as part of larger Newton changes to the Install Guide (see <a href="https://review.openstack.org/#/c/301284" rel="noreferrer" target="_blank">https://review.openstack.org/#/c/301284</a>). I'd love your feedback.<br>
<br>
HTH,<br>
Lana<br>
<span class="HOEnZb"><font color="#888888"><br>
--<br>
Lana Brindley<br>
Technical Writer<br>
Rackspace Cloud Builders Australia<br>
<a href="http://lanabrindley.com" rel="noreferrer" target="_blank">http://lanabrindley.com</a><br>
<br>
</font></span><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" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><font face="comic sans ms, sans-serif">Thanks,</font></div><div dir="ltr"><font face="comic sans ms, sans-serif"><br></font><div><font face="comic sans ms, sans-serif" size="2" color="#000000" style="background-color:rgb(255,255,255)">Svetlana Karslioglu</font></div><div><font face="comic sans ms, sans-serif" size="2" color="#000000" style="background-color:rgb(255,255,255)">Sr. Technical Writer</font></div><div><font face="comic sans ms, sans-serif" size="2" color="#000000" style="background-color:rgb(255,255,255)">Mirantis, Inc.</font></div><div><font face="comic sans ms, sans-serif" size="2" color="#000000" style="background-color:rgb(255,255,255)">408-476-1692</font></div><div><br></div></div></div></div></div></div></div></div></div>
</div></div>