Re: [openstack-dev] [doc][i18n][infra][tc] plan for PDF and translation builds for documentation

2018-09-13 Thread Doug Hellmann
Excerpts from Matthew Treinish's message of 2018-09-13 23:21:43 -0400: > On Fri, Sep 14, 2018 at 10:09:26AM +0900, Ian Y. Choi wrote: > > When I test PDF builds on current nova repo with master branch, it seems > > that the rst document is too big > > (876 pages with error) and more dealing with

Re: [openstack-dev] [doc][i18n][infra][tc] plan for PDF and translation builds for documentation

2018-09-13 Thread Matthew Treinish
On Fri, Sep 14, 2018 at 10:09:26AM +0900, Ian Y. Choi wrote: > First of all, thanks a lot for nice summary - I would like to deeply > read and put comments later. > > And @mtreinish, please see my reply inline: > > Matthew Treinish wrote on 9/14/2018 5:09 AM: > > On Thu, Sep 13, 2018 at

Re: [openstack-dev] [doc][i18n][infra][tc] plan for PDF and translation builds for documentation

2018-09-13 Thread Ian Y. Choi
First of all, thanks a lot for nice summary - I would like to deeply read and put comments later. And @mtreinish, please see my reply inline: Matthew Treinish wrote on 9/14/2018 5:09 AM: > On Thu, Sep 13, 2018 at 07:23:53AM -0600, Doug Hellmann wrote: >> Excerpts from Michel Peterson's message

Re: [openstack-dev] [doc][i18n][infra][tc] plan for PDF and translation builds for documentation

2018-09-13 Thread Matthew Treinish
On Thu, Sep 13, 2018 at 07:23:53AM -0600, Doug Hellmann wrote: > Excerpts from Michel Peterson's message of 2018-09-13 10:04:27 +0300: > > On Thu, Sep 13, 2018 at 1:09 AM, Doug Hellmann > > wrote: > > > > > The longer version is that we want to continue to use the existing > > > tox environment

Re: [openstack-dev] [doc][i18n][infra][tc] plan for PDF and translation builds for documentation

2018-09-13 Thread Doug Hellmann
Excerpts from Michel Peterson's message of 2018-09-13 10:04:27 +0300: > On Thu, Sep 13, 2018 at 1:09 AM, Doug Hellmann > wrote: > > > The longer version is that we want to continue to use the existing > > tox environment in each project as the basis for the job, since > > that allows teams to

Re: [openstack-dev] [doc][i18n][infra][tc] plan for PDF and translation builds for documentation

2018-09-13 Thread Doug Hellmann
Excerpts from Andreas Jaeger's message of 2018-09-13 08:14:30 +0200: > I like the plan, thanks! One suggestion below: > > The translated documents are build for releasenotes already in a similar > way as proposed. here we update the index.rst file on the fly to link to > all translated

Re: [openstack-dev] [doc][i18n][infra][tc] plan for PDF and translation builds for documentation

2018-09-13 Thread Michel Peterson
On Thu, Sep 13, 2018 at 1:09 AM, Doug Hellmann wrote: > The longer version is that we want to continue to use the existing > tox environment in each project as the basis for the job, since > that allows teams to control the version of python used, the > dependencies installed, and add custom

Re: [openstack-dev] [doc][i18n][infra][tc] plan for PDF and translation builds for documentation

2018-09-13 Thread Andreas Jaeger
I like the plan, thanks! One suggestion below: The translated documents are build for releasenotes already in a similar way as proposed. here we update the index.rst file on the fly to link to all translated versions, see the bottom of e.g.

[openstack-dev] [doc][i18n][infra][tc] plan for PDF and translation builds for documentation

2018-09-12 Thread Doug Hellmann
Ian has been working for a while on enabling PDF and translation support for our documentation build job [1][2]. After exploring a few different approaches, today at the PTG I think we were able to agree on a plan that will let us move ahead. The tl;dr version is that we want to add some extra