[docs] Project guides in PDF format

Jeremy Stanley fungi at yuggoth.org
Tue Mar 30 00:07:05 UTC 2021


On 2021-03-29 19:47:24 -0400 (-0400), Peter Matulis wrote:
> I changed the testenv to 'pdf-docs' and the build is still being skipped.
> 
> Do I need to submit a PR to have this [1] set to 'false'?
> 
> [1]:
> https://opendev.org/openstack/openstack-zuul-jobs/src/commit/01746b6df094c25f0cd67690b44adca0fb4ee1fd/zuul.d/jobs.yaml#L970
[...]

Oh, yep that'll need to be adjusted or overridden as well. I see
that https://review.opendev.org/678077 explicitly chose not to do
PDF builds for deploy guides for the original PDF docs
implementation a couple of years ago. Unfortunately the commit
message doesn't say why, but maybe this is a good opportunity to
start. However, many (most?) API projects seem to include their
deployment guides in their software Git repos, so switching this on
for everyone might break their deploy guide builds. If we combine it
with an expectation for a deploy-guide-specific PDF building tox
testenv like you had previously, then it would get safely skipped by
any projects without that testenv defined.
-- 
Jeremy Stanley
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <http://lists.openstack.org/pipermail/openstack-discuss/attachments/20210330/3de2679c/attachment.sig>


More information about the openstack-discuss mailing list