Merge pull request #421 from klihub/devel/docs/update-toolchain

docs: fix build error, avoid testdata scan infinite loop.

docs/Dockerfile

@@ -1,10 +1,12 @@
-FROM sphinxdoc/sphinx:5.3.0
+FROM sphinxdoc/sphinx:7.4.7
+
+ARG GO_VERSION=1.23.3
 
 RUN apt-get update && apt-get install -y wget git
 
 # Note: Any golang version that can 'go list -m -f {{.Variable}}' is fine...
-RUN wget https://go.dev/dl/go1.20.4.linux-amd64.tar.gz && \
-    tar -C /usr/local -xzf go1.20.4.linux-amd64.tar.gz
+RUN wget https://go.dev/dl/go${GO_VERSION}.linux-amd64.tar.gz && \
+    tar -C /usr/local -xzf go${GO_VERSION}.linux-amd64.tar.gz
 
 ENV PATH=$PATH:/usr/local/go/bin
 

docs/conf.py

@@ -127,7 +127,7 @@ def gomod_versions(modules):
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This pattern also affects html_static_path and html_extra_path.
-exclude_patterns = ['build', 'build-aux', '_build', '.github', '_work', 'generate', 'README.md', 'TODO.md', 'SECURITY.md', 'CODE-OF-CONDUCT.md', 'docs/releases', 'test/self-hosted-runner/README.md', 'test/e2e/README.md', 'docs/resource-policy/releases', 'docs/resource-policy/README.md','test/statistics-analysis/README.md', 'deployment/helm/*/*.md']
+exclude_patterns = ['build', 'build-aux', '_build', '.github', '_work', 'generate', 'README.md', 'TODO.md', 'SECURITY.md', 'CODE-OF-CONDUCT.md', 'docs/releases', 'test/self-hosted-runner/README.md', 'test/e2e/README.md', 'docs/resource-policy/releases', 'docs/resource-policy/README.md','test/statistics-analysis/README.md', 'deployment/helm/*/*.md', '**/testdata']
 
 # -- Options for HTML output -------------------------------------------------
 

docs/requirements.txt

@@ -1,5 +1,5 @@
-sphinx==5.3.0
-sphinx_rtd_theme==1.2.2
-myst-parser==0.19.2
+sphinx==7.4.7
+sphinx_rtd_theme==2.0.0
+myst-parser==4.0.0
 sphinx-markdown-tables==0.0.17
-Pygments==2.15.0
+Pygments==2.17.0