diff --git a/docs/pyproject.md b/docs/pyproject.md
index 11f8ce13971..1a496f5cedb 100644
--- a/docs/pyproject.md
+++ b/docs/pyproject.md
@@ -214,6 +214,18 @@ packages = [
 ]
 ```
 
+The `to` parameter is designed to specify the relative destination path
+where the package will be located upon installation. This allows for
+greater control over the organization of packages within your project's structure.
+
+```toml
+[tool.poetry]
+# ...
+packages = [
+    { include = "my_package", from = "lib", to = "target_package" },
+]
+```
+
 If you want to restrict a package to a specific build format you can specify
 it by using `format`: