[openstack-dev] [OpenStack-docs] [all] Changes to releasenotes and docs build jobs
doug at doughellmann.com
Wed Nov 22 20:21:30 UTC 2017
> On Nov 22, 2017, at 11:22 AM, Ian Y. Choi <ianyrchoi at gmail.com> wrote:
> Maybe there would be some chance to be also considered with PDF builds?
> I created an WIP patch on openstack/horizon repository  to highlight
> which changes to be needed for PDF build support on docs and releasenotes.
> Although there is currently one warning using "python setup.py build_sphinx" ,
> I think the warning would be quite fine now since using sphinx-build command with
> "-b latex" option works well and such command execution is how PTI is going from my understanding .
It does make sense to build PDFs. Do you think we want to always build them?
> (I am also copying this to openstack-docs mailing list for .)
We really really need to stop using that separate mailing list. Now that the project teams are managing their own documentation, we should just have the docs discussions on the -dev list so everyone can participate.
> With many thanks,
>  https://review.openstack.org/#/c/520620/
>  https://github.com/sphinx-doc/sphinx/issues/4259
>  http://git.openstack.org/cgit/openstack-infra/zuul-jobs/tree/roles/sphinx/tasks/main.yaml#n15
>  https://review.openstack.org/#/c/509297/
> Doug Hellmann wrote on 11/23/2017 12:05 AM:
>> Excerpts from Monty Taylor's message of 2017-11-22 07:39:45 -0600:
>>> * We use -W for all releasenotes builds - this means warnings are always
>>> errors for releasenotes. That shouldn't bother anyone, as most of the
>>> releasenotes content is generated by reno anyway.
>> For projects that never had -W set, there may be invalid RST in old
>> branches. We hit that in ceilometer for mitaka and newton, and since
>> those branches were closed already we used "reno report" to generate
>> static RST pages to replace the reno directives. See
>> https://review.openstack.org/#/c/521548/ for an example of doing this if
>> your project has a similar issue.
>> OpenStack Development Mailing List (not for usage questions)
>> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> OpenStack-docs mailing list
> OpenStack-docs at lists.openstack.org
More information about the OpenStack-dev