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

Doug Hellmann doug at doughellmann.com
Thu Sep 13 13:17:08 UTC 2018


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 versions, see the bottom of e.g. 
> https://docs.openstack.org/releasenotes/openstack-manuals/
> 
> I suggest that you look also as part of building how to link to PDFs and 
> translated documents.
> 
> For reference, the logic for releasenotes translation is here:
> http://git.openstack.org/cgit/openstack-infra/zuul-jobs/tree/roles/build-releasenotes/tasks/main.yaml#n10

Ah, yes, that's a detail I left out. I want to add a directive to
the theme to list those other formats and versions, so we don't
have to edit the content of the file on the fly.

> I would appreciate if you handle releasenotes the same way as other 
> documents, so if you want to change releasenotes in the end, please do

Good idea.

Doug



More information about the OpenStack-dev mailing list