diff --git a/docs/user/build-customization.rst b/docs/user/build-customization.rst
index ed65eb84306..0de645309f0 100644
--- a/docs/user/build-customization.rst
+++ b/docs/user/build-customization.rst
@@ -310,7 +310,7 @@ Install dependencies with Poetry
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Projects managed with `Poetry <https://python-poetry.org/>`__,
-can use the ``post_create_environment`` user-defined job to install Poetry and ``post_install`` to install Python dependencies.
+can use the ``post_create_environment`` user-defined job to use Poetry for installing Python dependencies.
 Take a look at the following example:
 
 
@@ -326,10 +326,10 @@ Take a look at the following example:
      jobs:
        post_create_environment:
          # Install poetry
+         # https://python-poetry.org/docs/#installing-manually
          - pip install poetry
          # Tell poetry to not use a virtual environment
          - poetry config virtualenvs.create false
-       post_install:
          # Install dependencies with 'docs' dependency group
          # https://python-poetry.org/docs/managing-dependencies/#dependency-groups
          - poetry install --with docs