[OpenStack-docs] Developer and users documentation

Petr Kovar pkovar at redhat.com
Mon Apr 18 22:06:56 UTC 2016


On Fri, 15 Apr 2016 06:28:58 +1000
Lana Brindley <openstack at lanabrindley.com> wrote:

> On 15/04/16 04:34, Svetlana Karslioglu wrote:
> > Hi Lana and all, 
> > 
> > I have the following questions:
> > 
> >  1. How users can find the documentation published at docs.openstack.org/developer <http://docs.openstack.org/developer> from the docs.openstack.org <http://docs.openstack.org> page? I couldn't find a way to do it. It looks like unless you know the link to docs.openstacl.org/developer <http://docs.openstacl.org/developer>, you cannot find this documentation. Shouldn't the link to developer's documentation be added to docs.openstack.org <http://docs.openstack.org>?
> 
> 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?
> 
> >  2. How to access previous versions of documentation published at docs.openstack.org/developer <http://docs.openstack.org/developer>? I tried the following and it did not work:
> >       * http://docs.openstack.org/developer/liberty
> >       * http://docs.openstack.org/liberty/developer
> 
> 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.

How is /developer assembled? Is this controlled by the developer project
owners or someone else? Looks like one or two projects hosted
under /developer are missing from that page, should I file a bug somewhere? 

Thanks,
pk



More information about the OpenStack-docs mailing list