diff --git a/docs/docs/pyproject.md b/docs/docs/pyproject.md
index 3bf1d11a780..b33110d7e4e 100644
--- a/docs/docs/pyproject.md
+++ b/docs/docs/pyproject.md
@@ -216,6 +216,10 @@ poetry = 'poetry.console:run'
 
 Here, we will have the `poetry` script installed which will execute `console.run` in the `poetry` package.
 
+!!!note
+
+    When a script is added or updated, run `poetry install` to make them available in the project's virtualenv.
+
 ## `extras`
 
 Poetry supports extras to allow expression of: