Tweaks

setup/upgrade_minor.rst

@@ -21,25 +21,23 @@ There are two steps to upgrading a minor version:
 1) Update the Symfony Library via Composer
 ------------------------------------------
 
-Your composer.json file should already be configured to allow your Symfony packages to be upgraded minor versions. But, if a package was not upgraded that should have been, check your ``composer.json`` file.
+Your ``composer.json`` file should already be configured to allow your Symfony
+packages to be upgraded to minor versions. But, if a package was not upgraded,
+check that the version constrains of your Symfony dependencies are like this:
 
 .. code-block:: json
 
     {
         "...": "...",
 
         "require": {
-            "symfony/asset": "^4.0",
+            "symfony/cache": "^4.0",
+            "symfony/config": "^4.0",
             "symfony/console": "^4.0",
-            "symfony/expression-language": "^4.0",
-            "symfony/form": "^4.0",
-            "symfony/framework-bundle": "^4.0",
-            "symfony/process": "^4.0",
-            "symfony/security-bundle": "^4.0",
-            "symfony/twig-bundle": "^4.0",
-            "symfony/validator": "^4.0",
-            "symfony/web-link": "^4.0",
-            "symfony/yaml": "^4.0"
+            "symfony/debug": "^4.0",
+            "symfony/dependency-injection": "^4.0",
+            "symfony/dotenv": "^4.0",
+            "...": "..."
         },
         "...": "...",
     }

setup/upgrade_patch.rst

@@ -6,9 +6,12 @@ Upgrading a Patch Version (e.g. 4.1.0 to 4.1.1)
 
 When a new patch version is released (only the last number changed), it is a
 release that only contains bug fixes. This means that upgrading to a new patch
-version is *really* easy:
+version is *really* easy.
 
-To upgrade to a new "patch" release, see the :doc:Upgrading a Minor Version </setup/upgrade_minor> documentation. Thanks to Symfony's backwards compatibility promise, it's always safe to upgrade to the latest "minor" version.
+To upgrade to a new "patch" release, read the
+:doc:`Upgrading a Minor Version </setup/upgrade_minor>` article. Thanks to
+Symfony's :doc`backwards compatibility promise </contributing/code/bc>`, it's
+always safe to upgrade to the latest "minor" version.
 
 .. tip::