Daniel P. Berrangé <berra...@redhat.com> writes: > On Mon, Aug 04, 2025 at 05:29:59PM +0100, Alex Bennée wrote: >> We don't build the PDFs ourselves for the hosted docs and it looks >> like rtd can't manage building PDFs now they have gone over a certain >> size. Disable the extra formats so we can at least have the online >> stuff again. > > Regardless of build problems, IMHO, we should not have been building > the PDFs as no effort is being made to validate that the content is > formatting well under the layout constraints of PDFs
True. I will say the one thing I have found PDFs good for is uploading the docs into a LLM context like NotebookLM. Otherwise you end up having to add individual links which a) is a pain and b) is a potential DDoS source if the model keeps hitting the host which as I'm sure everyone is aware is a problem for FLOSS archives at the moment. I would hope longer term there are better solutions for archiving our docs as context if we want to provide it to things like bug assistants or auto-reviews. I noticed virtiofsd is now using GitLabs AI tools to aid MR processing. > >> >> Signed-off-by: Alex Bennée <alex.ben...@linaro.org> >> --- >> .readthedocs.yml | 2 -- >> 1 file changed, 2 deletions(-) > > Reviewed-by: Daniel P. Berrangé <berra...@redhat.com> > > With regards, > Daniel -- Alex Bennée Virtualisation Tech Lead @ Linaro
