Re: [RFC PATCH] readthedocs: don't build extra formats

["Alex Bennée" <alex.bennee@linaro.org>]

Daniel P. Berrangé <berrange@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.bennee@linaro.org>
>> ---
>>  .readthedocs.yml | 2 --
>>  1 file changed, 2 deletions(-)
>
> Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
>
> With regards,
> Daniel

-- 
Alex Bennée
Virtualisation Tech Lead @ Linaro