From b78570055d371099e44a3150079f30d085f9b491 Mon Sep 17 00:00:00 2001 From: Ian Dunn Date: Tue, 31 Aug 2021 11:44:46 -0700 Subject: [PATCH] Docs: Place general troubleshooting steps in a more logical order * `self-update` should be run first, because it may affect the results of `diagnose`. * `clear-cache` should be run before `update`, otherwise `update` would need to be run again after clearing the cache. --- doc/articles/troubleshooting.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/doc/articles/troubleshooting.md b/doc/articles/troubleshooting.md index 13ed340ed..669d4ce55 100644 --- a/doc/articles/troubleshooting.md +++ b/doc/articles/troubleshooting.md @@ -7,22 +7,22 @@ This is a list of common pitfalls on using Composer, and how to avoid them. ## General -1. Before asking anyone, run [`composer diagnose`](../03-cli.md#diagnose) to check - for common problems. If it all checks out, proceed to the next steps. - -2. When facing any kind of problems using Composer, be sure to **work with the +1. When facing any kind of problems using Composer, be sure to **work with the latest version**. See [self-update](../03-cli.md#self-update) for details. + +2. Before asking anyone, run [`composer diagnose`](../03-cli.md#diagnose) to check + for common problems. If it all checks out, proceed to the next steps. 3. Make sure you have no problems with your setup by running the installer's checks via `curl -sS https://getcomposer.org/installer | php -- --check`. -4. Ensure you're **installing vendors straight from your `composer.json`** via +4. Try clearing Composer's cache by running `composer clear-cache`. + +5. Ensure you're **installing vendors straight from your `composer.json`** via `rm -rf vendor && composer update -v` when troubleshooting, excluding any possible interferences with existing vendor installations or `composer.lock` entries. -5. Try clearing Composer's cache by running `composer clear-cache`. - ## Package not found 1. Double-check you **don't have typos** in your `composer.json` or repository