diff --git a/docs/pyproject.md b/docs/pyproject.md
index 39b7b192253..8221ac89612 100644
--- a/docs/pyproject.md
+++ b/docs/pyproject.md
@@ -728,7 +728,17 @@ Here, we will have the `my_package_cli` script installed which will execute the
 When a script is added or updated, run `poetry install` to make them available in the project's virtualenv.
 {{% /note %}}
 
-### extras
+```toml
+[tool.poetry.scripts]
+my_executable = { reference = "some_binary.exe", type = "file" }
+```
+
+With this configuration, Poetry will look for the referenced file in the active project and then copy it to the OS installation directory.
+
+* On Windows the file is placed in the `Scripts/` directory.
+* On *nix system the file is placed in the `bin/` directory.
+
+## `extras`
 
 **Deprecated**: Use `project.optional-dependencies` instead.