Full documentation as a single page for LLMs

[thiswillbeyourgithub]

• whitespace
• doc: add full doc as a single page for LLMs

As discussed in #754

On my local build, done with cd docs then make clean html, there's the header issue but it might be just me, might be a readthedocs bug and might happen in the website version, and is not that bad anyway IMHO.

edit: put in draft again until I double check the errors when building the docs

[thiswillbeyourgithub]

Okay so the current pr is fine. I think it does not interfere at all with the current doc, just adds the new page and reference to it. But apparently the actual good way of doing this would be to use a custom readthedocs builder and that might be quite involved. And would be quite a bit harder for me because I don't have access to readthedocs.

[thiswillbeyourgithub]

Thanks for being open to the idea! I tried clicking on the link in the readme and it 404, has the doc not automatically rebuilt itself?

[amoffat]

The merge broke the docs. It was the only change in the past 2 months, since the docs last built successfully

[thiswillbeyourgithub]

I noticed that in my wdoc I have the theme in my requirements for the doc: https://github.com/thiswillbeyourgithub/wdoc/blob/main/docs/requirements.txt

Maybe this would help?

Are you sure the build was succesful previously because I thought I saw differences between the local build I have made even before started coding and what I was seeing on the online version.

[thiswillbeyourgithub]

Also iirc my local build was using sphinx 8.2.3

[amoffat]

You're right, I misread.. looks like the docs have been broken for awhile. Ay....

[thiswillbeyourgithub]

Try maybe with those in the req:
Sphinx 8.2.3
sphinx-rtd-theme 3.0.2

[thiswillbeyourgithub]

BTW, though not very used to readthedocs I am willing to help you out of you give me the error messages etc. This is usually something dumb.