diff --git a/docs/cli.md b/docs/cli.md
index cda2bd9a4d0..67020f2c33c 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -839,10 +839,10 @@ poetry cache list
 
 The `cache clear` command removes packages from a cached repository.
 
-For example, to clear the whole cache of packages from the `pypi` repository, run:
+For example, to clear the whole cache of packages from the `PyPI` repository, run:
 
 ```bash
-poetry cache clear pypi --all
+poetry cache clear PyPI --all
 ```
 
 To only remove a specific package from a cache, you have to specify the cache entry in the following form `cache:package:version`:
diff --git a/docs/contributing.md b/docs/contributing.md
index 995e899a4a7..3252e88bab3 100644
--- a/docs/contributing.md
+++ b/docs/contributing.md
@@ -33,6 +33,8 @@ related reports.
 * **Check that your issue does not already exist** in the [issue tracker].
 * **Make sure your issue is really a bug, and is not a support request or question** better suited for [Discussions]
 or [Discord].
+* **Try running your commands with the** `--no-cache` **flag**.
+* **Try clearing your cache with** `poetry cache clear --all PyPI` **and rerunning your commands**.
 
 {{% note %}}
 If you find a **Closed** issue that seems like it is the same thing that you're experiencing, open a new issue and