Docs: cache clear page still shows lowercase pypi in package specific example after #9736 fix (original) (raw)

Issue Kind

Error in existing documentation

Existing Link

https://python-poetry.org/docs/cli/#cache-clear

Description

Doc page: https://python-poetry.org/docs/cli/#cache-clear

Problem:
PR #9736 fixed the --all example to use PyPI (capitalized), closing #9516. However, the specific package removal example on the same page was not updated and still reads:

poetry cache clear pypi:requests:2.24.0

This is inconsistent with the PyPI casing used directly above it on the same page. Since the cache name is case-sensitive (as demonstrated in #9516). On systems where the repository cache directory is PyPI (as in #9516), this example can result in no entries being cleared when copy/pasted.

Problem Screenshot:

Suggested fix:
The example should either be updated to be consistent with the PyPI casing used directly above it, or a note should be added advising users to first run poetry cache list, and use the exact cache name shown on their system, referencing the cache list command documented advising users to first run poetry cache list and use the exact cache name shown on their system.

References:

• Original issue: In the docs about clearing the cache, pypi is in lowercase (does not work) #9516
• Fix PR: Docs updates #9736 (which updated the --all example but not this one)