ci: refresh docs build dependencies

[ansible-documentation-bot]

No description provided.

[samccann]

@oraNod @gotmax23 - anyone know why rstcheck is dropped down multiple versions in this PR - https://github.com/ansible/ansible-documentation/pull/1708/files#diff-f3e33d99f9b9fef050ee5b226fa3aedb48919f53d607a445970e11ffb0bf66ffR108

[oraNod]

@oraNod @gotmax23 - anyone know why rstcheck is dropped down multiple versions in this PR - https://github.com/ansible/ansible-documentation/pull/1708/files#diff-f3e33d99f9b9fef050ee5b226fa3aedb48919f53d607a445970e11ffb0bf66ffR108

nice catch @samccann I'm not sure why rstcheck was dropped down. initially I was thinking maybe it was related to one of the other dependencies, perhaps sphinx. but I don't think that's the case. I know rstcheck has an upper bound:

ansible-documentation/tests/constraints-base.in

Line 3 in be8bc9f

rstcheck < 6 # rstcheck 6.x has problem with rstcheck.core triggered by include files w/ sphinx directives https://github.com/rstcheck/rstcheck-core/issues/3

but this doesn't explain why the version would drop. afaik this PR is produced with the equivalent of pip-compile --upgrade <requirements>

[oraNod]

@samccann Hey, I guess this one slipped through the cracks a little. I took another look and it seems there is an incompatibility with a docutils for rstcheck 5.0.0 and sphinx 7.4.7.

I set up a test venv:

$ rstcheck --version
rstcheck 5.0.0

$ python -m pip install --upgrade sphinx==7.4.7

...

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts.
rstcheck 5.0.0 requires docutils<0.19,>=0.7, but you have docutils 0.21.2 which is incompatible.
Successfully installed Jinja2-3.1.4 MarkupSafe-2.1.5 alabaster-0.7.16 babel-2.16.0 certifi-2024.7.4 charset-normalizer-3.3.2 docutils-0.21.2 imagesize-1.4.1 requests-2.32.3 snowballstemmer-2.2.0 sphinx-7.4.7 sphinxcontrib-applehelp-2.0.0 sphinxcontrib-devhelp-2.0.0 sphinxcontrib-htmlhelp-2.1.0 sphinxcontrib-jsmath-1.0.1 sphinxcontrib-qthelp-2.0.0 sphinxcontrib-serializinghtml-2.0.0 urllib3-2.2.2

$ docutils --version
docutils (Docutils 0.21.2, Python 3.12.4, on linux)

$ sphinx-build --version
sphinx-build 7.4.7

[oraNod]

LGTM. The rstcheck version change is in requirements-relaxed.txt which is used for dev / experimental builds so shouldn't be a problem.