| opendevreview | Dmitriy Chubinidze proposed openstack/openstack-manuals master: Revert "docs: increasing file descriptor limit" https://review.opendev.org/c/openstack/openstack-manuals/+/944314 | 07:52 |
|---|---|---|
| *** elodilles_pto is now known as elodilles | 08:19 | |
| *** ralonsoh_ is now known as ralonsoh | 09:49 | |
| clarkb | there was a big push at one point to build pdf versions of project docs. Unfortunately, installing the tooling to do that can be slow: https://zuul.opendev.org/t/openstack/build/158af9134783416b946b630d0e2af637/log/job-output.txt#519-520 as can the actual pdf build (which timed out): | 20:48 |
| clarkb | https://zuul.opendev.org/t/openstack/build/158af9134783416b946b630d0e2af637/log/job-output.txt#4191 | 20:48 |
| clarkb | I don't recall the original motiviation for pdf docs, but maybe we should reconsider buildingthem on every change if they are less reliable and instead do a daily doc update or something along those lines? | 20:49 |
| clarkb | or otherwise look into improving the throughput of those builds. I know the toolchain is fairly large which is part of hte problem. but then maybe there are ways to get pdf generation to go quicker | 20:51 |
| fungi | spotz[m]: maybe you recall, was that something that came out of ops discussions at some point? | 20:59 |
| gouthamr | sounds reasonable to make the pdf builds periodic instead of per-commit | 21:11 |
| gouthamr | we could add a disclaimer that the pdf doc may be stale by <24 hours if we do it this way.. | 21:12 |
| clarkb | looks like in the example I put there it instaleld all of the pdf build deps then timed out when building the regular docs | 21:19 |
| clarkb | it never even got to pdf doc builds | 21:19 |
| clarkb | so there are several slow bits and they add up. Looks like we are doing sphinx-build -j auto at least | 21:21 |
| clarkb | in cinder | 21:21 |
| clarkb | however cinder's pdf-docs target doesn't use -j auto | 21:21 |
| clarkb | I suspect that projects with large amounts of documentation are going to be more prone to timing out. Every project building pdf docs has to incur the pdf toolchain install cost, but its when the docs are slow to build due to their size that we trip over the job timeouts | 21:23 |
Generated by irclog2html.py 2.17.3 by Marius Gedminas - find it at https://mg.pov.lt/irclog2html/!