[WIP] Fix documentation so that 'make doctest' passes (#191)

* Initial plan for issue

* Fix doctest target and resolve sphinx warnings

Co-authored-by: eh-main-bot <171766998+eh-main-bot@users.noreply.github.com>

* Update Read the Docs configuration to use Ubuntu LTS and Python 3.12

* Address code review feedback on doctest target and _static directory

Co-authored-by: eh-main-bot <171766998+eh-main-bot@users.noreply.github.com>

* Remove unnecessary doctest command line as requested in code review

Co-authored-by: eh-main-bot <171766998+eh-main-bot@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: eh-main-bot <171766998+eh-main-bot@users.noreply.github.com>
Co-authored-by: Daniel Avdar <66269169+DanielAvdar@users.noreply.github.com>

Author: 3 people

.gitignore

@@ -117,3 +117,6 @@ venv.bak/
 
 # PyCharm
 .idea/
+
+# Generated test files
+kfp_functions.py

.readthedocs.yaml

@@ -13,16 +13,10 @@ formats: all
 
 # Set the OS, Python version, and other tools you might need
 build:
-  os: "ubuntu-22.04"
+  os: ubuntu-lts-latest
   tools:
-    python: "3.10"
+    python: "3.12"
   jobs:
-    post_create_environment:
-      # Install poetry
-      # https://python-poetry.org/docs/#installing-manually
-      - pip install poetry
     post_install:
-      # Install dependencies with 'docs' dependency group
-      # https://python-poetry.org/docs/managing-dependencies/#dependency-groups
-      # VIRTUAL_ENV needs to be set manually for now, see #11150
-      - VIRTUAL_ENV=$READTHEDOCS_VIRTUALENV_PATH poetry install
+      - pip install uv
+      - UV_PROJECT_ENVIRONMENT=$READTHEDOCS_VIRTUALENV_PATH uv sync --group docs --link-mode=copy --frozen --no-group dev

docs/source/conf.py

@@ -39,4 +39,4 @@
 # -- Options for HTML output -------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
-html_static_path = ["_static"]
+html_static_path = []