RTD: hard to understand what fails, the message doesn't include failing cause

[khsrali]

It shows many deprecation warnings that we don't need to worry about. and that makes searching for the word 'warning' difficult.

Even if you search and look carefully, you realize the actual warning message that causes the built to fail is not shown! 💁

at the moment the command is:
uv run sphinx-build -T -W --keep-going -b html -d _build/doctrees -D language=en docs/source $READTHEDOCS_OUTPUT/html

[ayushjariyal]

@khsrali Is this issue still unresolved?

[khsrali]

Yes, it's open!

You'll have to understand if (and why) the log would be different with or without uv

If the log is the same, how to "hide" deprecation warnings, and specifically emphasis what is the problem.

To experiment with this you can start by changing something "silly" in the documentation that would possibly break the build.

Then having your local setup all set, try to build via sphinx. And propose a solution by ideally changing only the main command:

uv run sphinx-build -T -W --keep-going -b html -d _build/doctrees -D language=en docs/source $READTHEDOCS_OUTPUT/html

[ayushjariyal]

Got it!
I’ll test the build with and without uv, check for log differences, and propose a minimal adjustment to suppress non-critical warnings while keeping errors clear.