Merge branch '6.4' into 7.0

* 6.4:
  [Upgrading] Recommend to delete cache when upgrading to a major version
  [AssetMapper] Mention PublicAssetsFilesystemInterface

Author: javiereguiluz

frontend/asset_mapper.rst

@@ -89,6 +89,13 @@ This will physically copy all the files from your mapped directories to
 ``public/assets/`` so that they're served directly by your web server.
 See :ref:`Deployment <asset-mapper-deployment>` for more details.
 
+.. tip::
+
+    If you need to copy the compiled assets to a different location (e.g. upload
+    them to S3), create a service that implements ``Symfony\Component\AssetMapper\Path\PublicAssetsFilesystemInterface``
+    and set its service id (or an alias) to ``asset_mapper.local_public_assets_filesystem``
+    (to replace the built-in service).
+
 Debugging: Seeing All Mapped Assets
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

setup/upgrade_major.rst

@@ -182,6 +182,19 @@ Next, use Composer to download new versions of the libraries:
 
     $ composer update "symfony/*"
 
+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
+
+    # run this command on Linux and macOS
+    $ rm -rf var/cache/*
+
+    # run this command on Windows
+    C:\> rmdir /s /q var\cache\*
+
 .. include:: /setup/_update_dep_errors.rst.inc
 
 .. include:: /setup/_update_all_packages.rst.inc