[docs] Implementation of the api-ref consolidation under doc/source/

Luigi Toscano ltoscano at redhat.com
Thu Feb 21 17:44:20 UTC 2019


On Thursday, 21 February 2019 18:34:03 CET Sean McGinnis wrote:
> On Thu, Feb 21, 2019 at 06:08:15PM +0100, Luigi Toscano wrote:
> > Hi all,
> > 
> > During the last PTG it was decided to move forward with the migration of
> > the api-ref documentation together with the rest of the documentation
> > [1]. This is one of the item still open after the (not so recent anymore)
> > massive documentation restructuring [2].
> 
> How is this going to work with the publishing of these separate content
> types to different locations?

I can just guess, as this is a work in progress and I don't know about most of 
the previous discussions.

The publishing job is just code and can be adapted to publish two (three) 
subtrees to different places, or exclude some directories.
The global index files from doc/source do not necessarily need to include all 
the index files of the subdirectories, so that shouldn't be a problem.

Do you have a specific concern that it may difficult to address?

Ciao
-- 
Luigi






More information about the openstack-discuss mailing list