tweaks thanks to review

weaverryan · weaverryan · commit d423e58942a2 · 2020-01-26T12:42:20.000-05:00
diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
@@ -34,7 +34,7 @@ When the major version is released (e.g. 5.0.0), all deprecated features and
 functionality are removed. So, as long as you've updated your code to stop
 using these deprecated features in the last version before the major (e.g.
 ``4.4.*``), you should be able to upgrade without a problem. That means that
-you should first :doc:`upgrade to the last minor version</setup/upgrade_minor>`
+you should first :doc:`upgrade to the last minor version </setup/upgrade_minor>`
 (e.g. 4.4) so that you can see *all* the deprecations.
 
 To help you find deprecations, notices are triggered whenever you end up
@@ -98,7 +98,7 @@ done!
 .. sidebar:: Using the Weak Deprecations Mode
 
     Sometimes, you can't fix all deprecations (e.g. something was deprecated
-    in 3.4 and you still need to support 3.3). In these cases, you can still
+    in 4.4 and you still need to support 4.3). In these cases, you can still
     use the bridge to fix as many deprecations as possible and then allow
     more of them to make your tests pass again. You can do this by using the
     ``SYMFONY_DEPRECATIONS_HELPER`` env variable:
diff --git a/setup/upgrade_minor.rst b/setup/upgrade_minor.rst
@@ -94,13 +94,17 @@ These documents can also be found in the `Symfony Repository`_.
 3) Updating Recipes
 -------------------
 
-Over time - and especially when you upgrade to a new version of a library, an
-updating version of the :ref:`recipe <recipes-description>` may be available.
+Over time - and especially when you upgrade to a new version of a library - an
+updated version of the :ref:`recipe <recipes-description>` may be available.
 These updates are usually minor - e.g. new comments in a configuration file - but
 it's a good idea to update the core Symfony recipes.
 
-Starting in ``symfony/flex`` version 1.6, several commands are available to help
-upgrade your recipes:
+Symfony Flex provides several commands to help upgrade your recipes. Be sure to
+commit any unrelated changes you're working on before starting:
+
+.. versionadded:: 1.6
+
+    The recipes commands were introduced in Symfony Flex 1.6.
 
 .. code-block:: terminal
 
@@ -119,7 +123,10 @@ the latest version of the recipe** which means that **your custom code will be
 overridden completely**. After updating a recipe, you need to carefully choose
 which changes you want, and undo the rest.
 
-For a detailed example, see the `SymfonyCasts Symfony 5 Upgrade Tutorial`_.
+.. admonition:: Screencast
+    :class: screencast
+
+    For a detailed example, see the `SymfonyCasts Symfony 5 Upgrade Tutorial`_.
 
 .. _`Symfony Repository`: https://github.com/symfony/symfony
 .. _`UPGRADE-4.4.md`: https://github.com/symfony/symfony/blob/4.4/UPGRADE-4.4.md
