diff --git a/docs/user/build-customization.rst b/docs/user/build-customization.rst
index d74f81c6185..d82a3cc9f8f 100644
--- a/docs/user/build-customization.rst
+++ b/docs/user/build-customization.rst
@@ -359,8 +359,8 @@ Take a look at the following example:
Install dependencies with ``uv``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-Projects managed with `uv `__,
-can use the ``post_create_environment`` user-defined job to use ``uv`` for installing Python dependencies.
+Projects can use `uv `__,
+to install Python dependencies, usually reducing the time taken to install compared to pip.
Take a look at the following example:
@@ -373,19 +373,15 @@ Take a look at the following example:
os: "ubuntu-22.04"
tools:
python: "3.10"
- jobs:
- post_create_environment:
- # Install uv
- - pip install uv
- post_install:
- # Install dependencies with 'docs' dependency group
- # VIRTUAL_ENV needs to be set manually for now.
- # See https://github.com/readthedocs/readthedocs.org/pull/11152/
- - VIRTUAL_ENV=$READTHEDOCS_VIRTUALENV_PATH uv pip install .[docs]
-
- sphinx:
- configuration: docs/conf.py
-
+ commands:
+ - asdf plugin add uv
+ - asdf install uv latest
+ - asdf global uv latest
+ - uv venv
+ - uv pip install .[docs]
+ - .venv/bin/python -m sphinx -T -b html -d docs/_build/doctrees -D language=en docs $READTHEDOCS_OUTPUT/html
+
+You can use ``-r docs/requirements.txt``, etc. instead as needed. MkDocs projects could use ``NO_COLOR=1 .venv/bin/mkdocs build --strict --site-dir $READTHEDOCS_OUTPUT/html`` instead.
Update Conda version
^^^^^^^^^^^^^^^^^^^^