diff --git a/docs/pyproject.md b/docs/pyproject.md
index 39b7b192253..2377f68dd11 100644
--- a/docs/pyproject.md
+++ b/docs/pyproject.md
@@ -622,12 +622,25 @@ Poetry is clever enough to detect Python subpackages.
 Thus, you only have to specify the directory where your root package resides.
 {{% /note %}}
 
-### include and exclude
+### exclude and include
 
-A list of patterns that will be included in the final package.
+{{% note %}}
+If you just want to include a package or module, which is not picked up automatically,
+use [packages]({{< relref "#packages" >}}) instead of `include`.
+{{% /note %}}
+
+A list of patterns that will be excluded or included in the final package.
+
+```toml
+[tool.poetry]
+# ...
+exclude = ["my_package/excluded.py"]
+include = ["CHANGELOG.md"]
+```
 
 You can explicitly specify to Poetry that a set of globs should be ignored or included for the purposes of packaging.
 The globs specified in the exclude field identify a set of files that are not included when a package is built.
+`include` has priority over `exclude`.
 
 If a VCS is being used for a package, the exclude field will be seeded with the VCS’ ignore settings (`.gitignore` for git for example).
 
@@ -635,12 +648,6 @@ If a VCS is being used for a package, the exclude field will be seeded with the
 Explicitly declaring entries in `include` will negate VCS' ignore settings.
 {{% /note %}}
 
-```toml
-[tool.poetry]
-# ...
-include = ["CHANGELOG.md"]
-```
-
 You can also specify the formats for which these patterns have to be included, as shown here:
 
 ```toml
@@ -648,7 +655,7 @@ You can also specify the formats for which these patterns have to be included, a
 # ...
 include = [
     { path = "tests", format = "sdist" },
-    { path = "for_wheel.txt", format = ["sdist", "wheel"] }
+    { path = "my_package/for_sdist_and_wheel.txt", format = ["sdist", "wheel"] }
 ]
 ```
 
@@ -656,9 +663,12 @@ If no format is specified, `include` defaults to only `sdist`.
 
 In contrast, `exclude` defaults to both `sdist` and `wheel`.
 
-```toml
-exclude = ["my_package/excluded.py"]
-```
+{{% warning %}}
+When a wheel is installed, its includes are unpacked straight into the `site-packages` directory.
+Pay attention to include top level files and directories with common names like
+`CHANGELOG.md`, `LICENSE`, `tests` or `docs` only in sdists and **not** in wheels.
+{{% /warning %}}
+
 
 ### dependencies and dependency groups
 
diff --git a/poetry.lock b/poetry.lock
index bca90648273..7377ff56383 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -983,7 +983,7 @@ develop = false
 type = "git"
 url = "https://github.com/python-poetry/poetry-core.git"
 reference = "main"
-resolved_reference = "beb93b1aba6ad47667c05721a74c8f3961402046"
+resolved_reference = "eb68b291ccbb1ff226e04cdd5a58acc6e6053c0a"
 
 [[package]]
 name = "pre-commit"