Reword

Author: javiereguiluz

setup/upgrade_major.rst

@@ -182,15 +182,18 @@ Next, use Composer to download new versions of the libraries:
 
     $ composer update "symfony/*"
 
-It's also recommended to clear the cache after updating to a new major version:
+A best practice after updating to a new major version is to clear the cache.
+Instead of running the ``cache:clear`` command (which won't work if the application
+is not bootable in the console after the upgrade) it's better to remove the entire
+cache directory contents:
 
 .. code-block:: terminal
 
-    # this deletes the development cache in your local machine
-    $ php bin/console cache:clear
+    # run this command on Linux and macOS
+    $ rm -rf var/cache/*
 
-    # also delete the production cache in your local machine
-    $ APP_ENV=prod php bin/console cache:clear
+    # run this command on Windows
+    $ rmdir /s /q var\cache\*
 
 .. include:: /setup/_update_dep_errors.rst.inc