Is this related to an existing part of the documentation?

• Yes, it is related to an existing section

What needs to be updated?

📌 Current Documentation Issue

The documentation (or project instructions based on older versions of Poetry) suggests using the command:

poetry lock --no-update

However, in Poetry 2.2.x, this option no longer exists.
Running the command results in:

The option "--no-update" does not exist

This creates confusion because the documentation or project guide appears outdated and does not match Poetry’s current CLI behavior.

✨ Proposed Changes

Update the documentation to reflect the correct behavior for Poetry 2.x.

Clarify that:

--no-update was a valid flag in Poetry 1.x

It has been removed in Poetry 2.x

The correct replacement command is simply:

poetry lock

Optionally add a compatibility note for developers using older project templates or guides.

📋 Additional Context

I am using Poetry 2.2.1.

Python version: 3.10
(standard macOS + Homebrew setup).

Running poetry lock --no-update consistently throws:

The option "--no-update" does not exist

This behavior is not currently reflected in the documentation, which may mislead users who are following older project instructions or tutorials.

Relevant Documentation Link (if any)

https://python-poetry.org/docs/pre-commit-hooks#poetry-lock

Record

• I agree to follow this project's Code of Conduct
• I want to work on this update