From 775565e0c7f61141bd9acdc690448845a57cc6c6 Mon Sep 17 00:00:00 2001
From: bersbersbers <12128514+bersbersbers@users.noreply.github.com>
Date: Wed, 14 Feb 2024 16:35:16 +0100
Subject: [PATCH 1/3] State limitation of Poetry Core

Closes #8965
---
 docs/cli.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/cli.md b/docs/cli.md
index 5ea0b16051f..f4d69fcc30f 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -403,7 +403,7 @@ poetry add --editable ./my-package/
 poetry add --editable git+ssh://github.com/sdispater/pendulum.git#develop
 ```
 
-Alternatively, you can specify it in the `pyproject.toml` file. It means that changes in the local directory will be reflected directly in environment.
+Alternatively, you can specify it in the `pyproject.toml` file. It means that changes in the local directory will be reflected directly in environment. (This is not supported by Poetry Core.)
 
 ```toml
 [tool.poetry.dependencies]

From 8d523eb5493ab6e31dd32d427c70a0e962845ac8 Mon Sep 17 00:00:00 2001
From: bersbersbers <12128514+bersbersbers@users.noreply.github.com>
Date: Wed, 14 Feb 2024 22:06:18 +0100
Subject: [PATCH 2/3] Reformulate as a function of `poetry install`

---
 docs/cli.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/docs/cli.md b/docs/cli.md
index f4d69fcc30f..b952c3d63d2 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -403,7 +403,7 @@ poetry add --editable ./my-package/
 poetry add --editable git+ssh://github.com/sdispater/pendulum.git#develop
 ```
 
-Alternatively, you can specify it in the `pyproject.toml` file. It means that changes in the local directory will be reflected directly in environment. (This is not supported by Poetry Core.)
+Alternatively, you can specify it in the `pyproject.toml` file. It means that changes in the local directory will be reflected directly in environment.
 
 ```toml
 [tool.poetry.dependencies]
@@ -415,6 +415,10 @@ Before poetry 1.1 path dependencies were installed in editable mode by default.
 to make sure the behavior is the same for all poetry versions.
 {{% /note %}}
 
+{{% note %}}
+The `develop` attribute is understood only when using `poetry install`.
+{{% /note %}}
+
 If the package(s) you want to install provide extras, you can specify them
 when adding the package:
 

From 9868af3b6ab8421c82537a7e8065a2822c2da4b5 Mon Sep 17 00:00:00 2001
From: bersbersbers <12128514+bersbersbers@users.noreply.github.com>
Date: Fri, 16 Feb 2024 00:37:41 +0100
Subject: [PATCH 3/3] Accept suggestion
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Randy Döring <30527984+radoering@users.noreply.github.com>
---
 docs/cli.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/cli.md b/docs/cli.md
index b952c3d63d2..8e7efc7a11f 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -416,7 +416,8 @@ to make sure the behavior is the same for all poetry versions.
 {{% /note %}}
 
 {{% note %}}
-The `develop` attribute is understood only when using `poetry install`.
+The `develop` attribute is a Poetry-specific feature, so it is not included in the package distribution metadata.
+In other words, it is only considered when using Poetry to install the project.
 {{% /note %}}
 
 If the package(s) you want to install provide extras, you can specify them