[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