From 6a90c9b7519d97f5ba7e809d0c81320f966cbd04 Mon Sep 17 00:00:00 2001
From: WouterJ <waldio.webdesign@gmail.com>
Date: Tue, 10 Mar 2015 11:02:47 +0100
Subject: [PATCH 1/7] Created 'upgrade' cookbook section

---
 cookbook/index.rst                            |   2 +-
 cookbook/map.rst.inc                          |   5 +-
 cookbook/upgrade/_update_all_packages.rst.inc |  16 ++
 cookbook/upgrade/index.rst                    |  17 +++
 cookbook/upgrade/minor_version.rst            |  63 ++++++++
 cookbook/upgrade/patch_version.rst            |  26 ++++
 cookbook/upgrading.rst                        | 141 ------------------
 redirection_map                               |   1 +
 8 files changed, 127 insertions(+), 144 deletions(-)
 create mode 100644 cookbook/upgrade/_update_all_packages.rst.inc
 create mode 100644 cookbook/upgrade/index.rst
 create mode 100644 cookbook/upgrade/minor_version.rst
 create mode 100644 cookbook/upgrade/patch_version.rst
 delete mode 100644 cookbook/upgrading.rst

diff --git a/cookbook/index.rst b/cookbook/index.rst
index 03d29060c7f..2e0de5df7ef 100644
--- a/cookbook/index.rst
+++ b/cookbook/index.rst
@@ -28,7 +28,7 @@ The Cookbook
     symfony1
     templating/index
     testing/index
-    upgrading
+    upgrade/index
     validation/index
     web_server/index
     web_services/index
diff --git a/cookbook/map.rst.inc b/cookbook/map.rst.inc
index 6c8e5d59d89..92bc715cee4 100644
--- a/cookbook/map.rst.inc
+++ b/cookbook/map.rst.inc
@@ -201,9 +201,10 @@
   * (email) :doc:`/cookbook/email/testing`
   * (form) :doc:`/cookbook/form/unit_testing`
 
-* **Upgrading**
+* :doc:`/cookbook/upgrading/index`
 
-  * :doc:`/cookbook/upgrading`
+  * :doc:`/cookbook/upgrading/patch_version`
+  * :doc:`/cookbook/upgrading/minor_version`
 
 * :doc:`/cookbook/validation/index`
 
diff --git a/cookbook/upgrade/_update_all_packages.rst.inc b/cookbook/upgrade/_update_all_packages.rst.inc
new file mode 100644
index 00000000000..49d82e9fe12
--- /dev/null
+++ b/cookbook/upgrade/_update_all_packages.rst.inc
@@ -0,0 +1,16 @@
+You may also want to upgrade the rest of your libraries. If you've done a
+good job with your `version constraints`_ in ``composer.json``, you can do
+this safely by running:
+
+.. code-block:: bash
+
+    $ composer update
+
+.. caution::
+
+    Beware, if you have some bad `version constraints`_ in your
+    ``composer.json`` (e.g. ``dev-master``), this could upgrade some
+    non-Symfony libraries to new versions that contain backwards-compatibility
+    breaking changes.
+
+.. _`versino constraints`: https://getcomposer.org/doc/01-basic-usage.md#package-versions
diff --git a/cookbook/upgrade/index.rst b/cookbook/upgrade/index.rst
new file mode 100644
index 00000000000..fe4aeca3b4e
--- /dev/null
+++ b/cookbook/upgrade/index.rst
@@ -0,0 +1,17 @@
+.. index::
+    single: Upgrading
+
+Upgrading
+=========
+
+So a new Symfony release has come out and you want to upgrade, great! Fortunately,
+because Symfony protects backwards-compatibility very closely, this *should*
+be quite easy.
+
+There are three types of upgrades, all needing a little different preparation:
+
+.. toctree::
+    :maxdepth: 2
+
+    /cookbook/upgrade/patch_version
+    /cookbook/upgrade/minor_version
diff --git a/cookbook/upgrade/minor_version.rst b/cookbook/upgrade/minor_version.rst
new file mode 100644
index 00000000000..4a5a0fa023e
--- /dev/null
+++ b/cookbook/upgrade/minor_version.rst
@@ -0,0 +1,63 @@
+.. index::
+    single: Upgrading; Minor Version
+
+Upgrading a Minor Version (e.g. 2.5.3 to 2.6.1)
+===============================================
+
+If you're upgrading a minor version (where the middle number changes), then
+you should *not* encounter significant backwards compatibility changes. For
+details, see the :doc:`Symfony backwards compatibility promise </contributing/code/bc>`.
+
+However, some backwards-compatibility breaks *are* possible and you'll learn in
+a second how to prepare for them.
+
+There are two steps to upgrading a minor version:
+
+#. :ref:`Update the Symfony library via Composer <upgrade-minor-symfony-composer>`;
+#. :ref:`Update your code to work with the new version <upgrade-minor-symfony-code>`.
+
+.. _`upgrade-minor-symfony-composer`:
+
+1) Update the Symfony Library via Composer
+------------------------------------------
+
+First, you need to update Symfony by modifying your ``composer.json`` file
+to use the new version:
+
+.. code-block:: json
+
+    {
+        "...": "...",
+
+        "require": {
+            "symfony/symfony": "2.6.*",
+        },
+        "...": "...",
+    }
+
+Next, use Composer to download new versions of the libraries:
+
+.. code-block:: bash
+
+    $ composer update symfony/symfony
+
+.. include:: /cookbook/upgrade/_update_all_packages.rst.inc
+
+.. _`upgrade-minor-symfony-code`:
+
+2) Updating Your Code to Work with the new Version
+--------------------------------------------------
+
+In theory, you should be done! However, you *may* need to make a few changes
+to your code to get everything working. Additionally, some features you're
+using might still work, but might now be deprecated. While that's just fine,
+if you know about these deprecations, you can start to fix them over time.
+
+Every version of Symfony comes with an UPGRADE file included in the Symfony
+directory that describes these changes. If you follow the instructions in the
+document and update your code accordingly, it should be save to update in the
+future.
+
+These documents can also be found in the `Symfony Repository`_.
+
+.. _`Symfony Repository`: https://github.com/symfony/symfony
diff --git a/cookbook/upgrade/patch_version.rst b/cookbook/upgrade/patch_version.rst
new file mode 100644
index 00000000000..2968aa22c77
--- /dev/null
+++ b/cookbook/upgrade/patch_version.rst
@@ -0,0 +1,26 @@
+.. index::
+    single: Upgrading; Patch Version
+
+Upgrading a Patch Version (e.g. 2.6.0 to 2.6.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:
+
+.. code-block:: bash
+
+    $ composer update symfony/symfony
+
+That's it! You should not encounter any backwards-compatibility breaks or
+need to change anything else in your code. That's because when you started
+your project, your ``composer.json`` included Symfony using a constraint
+like ``2.6.*``, where only the *last* version number will change when you
+update.
+
+.. tip::
+
+    It is recommended to update to a new patch version as soon as possible, as
+    important bugs and security leaks may be fixed in these new releases.
+
+.. include:: /cookbook/upgrade/_update_all_packages.rst.inc
diff --git a/cookbook/upgrading.rst b/cookbook/upgrading.rst
deleted file mode 100644
index 0dc36fcd160..00000000000
--- a/cookbook/upgrading.rst
+++ /dev/null
@@ -1,141 +0,0 @@
-How to Upgrade Your Symfony Project
-===================================
-
-So a new Symfony release has come out and you want to upgrade, great! Fortunately,
-because Symfony protects backwards-compatibility very closely, this *should*
-be quite easy.
-
-There are two types of upgrades, and both are a little different:
-
-* :ref:`upgrading-patch-version`
-* :ref:`upgrading-minor-version`
-
-.. _upgrading-patch-version:
-
-Upgrading a Patch Version (e.g. 2.6.0 to 2.6.1)
------------------------------------------------
-
-If you're upgrading and only the patch version (the last number) is changing,
-then it's *really* easy:
-
-.. code-block:: bash
-
-    $ composer update symfony/symfony
-
-That's it! You should not encounter any backwards-compatibility breaks or
-need to change anything else in your code. That's because when you started
-your project, your ``composer.json`` included Symfony using a constraint
-like ``2.6.*``, where only the *last* version number will change when you
-update.
-
-You may also want to upgrade the rest of your libraries. If you've done a
-good job with your `version constraints`_ in ``composer.json``, you can do
-this safely by running:
-
-.. code-block:: bash
-
-    $ composer update
-
-But beware. If you have some bad `version constraints`_ in your ``composer.json``,
-(e.g. ``dev-master``), then this could upgrade some non-Symfony libraries
-to new versions that contain backwards-compatibility breaking changes.
-
-.. _upgrading-minor-version:
-
-Upgrading a Minor Version (e.g. 2.5.3 to 2.6.1)
------------------------------------------------
-
-If you're upgrading a minor version (where the middle number changes), then
-you should also *not* encounter significant backwards compatibility changes.
-For details, see our :doc:`/contributing/code/bc`.
-
-However, some backwards-compatibility breaks *are* possible, and you'll learn
-in a second how to prepare for them.
-
-There are two steps to upgrading:
-
-:ref:`upgrade-minor-symfony-composer`;
-:ref:`upgrade-minor-symfony-code`
-
-.. _`upgrade-minor-symfony-composer`:
-
-1) Update the Symfony Library via Composer
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-First, you need to update Symfony by modifying your ``composer.json`` file
-to use the new version:
-
-.. code-block:: json
-
-    {
-        "...": "...",
-
-        "require": {
-            "php": ">=5.3.3",
-            "symfony/symfony": "2.6.*",
-            "...": "... no changes to anything else..."
-        },
-        "...": "...",
-    }
-
-Next, use Composer to download new versions of the libraries:
-
-.. code-block:: bash
-
-    $ composer update symfony/symfony
-
-You may also want to upgrade the rest of your libraries. If you've done a
-good job with your `version constraints`_ in ``composer.json``, you can do
-this safely by running:
-
-.. code-block:: bash
-
-    $ composer update
-
-But beware. If you have some bad `version constraints`_ in your ``composer.json``,
-(e.g. ``dev-master``), then this could upgrade some non-Symfony libraries
-to new versions that contain backwards-compatibility breaking changes.
-
-.. _`upgrade-minor-symfony-code`:
-
-2) Updating Your Code to Work with the new Version
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-In theory, you should be done! However, you *may* need to make a few changes
-to your code to get everything working. Additionally, some features you're
-using might still work, but might now be deprecated. That's actually ok,
-but if you know about these deprecations, you can start to fix them over
-time.
-
-Every version of Symfony comes with an UPGRADE file that describes these
-changes. Below are links to the file for each version, which you'll need
-to read to see if you need any code changes.
-
-.. tip::
-
-    Don't see the version here that you're upgrading to? Just find the
-    UPGRADE-X.X.md file for the appropriate version on the `Symfony Repository`_.
-
-Upgrading to Symfony 2.6
-........................
-
-First, of course, update your ``composer.json`` file with the ``2.6`` version
-of Symfony as described above in :ref:`upgrade-minor-symfony-composer`.
-
-Next, check the `UPGRADE-2.6`_ document for details about any code changes
-that you might need to make in your project.
-
-Upgrading to Symfony 2.5
-........................
-
-First, of course, update your ``composer.json`` file with the ``2.5`` version
-of Symfony as described above in :ref:`upgrade-minor-symfony-composer`.
-
-Next, check the `UPGRADE-2.5`_ document for details about any code changes
-that you might need to make in your project.
-
-.. _`UPGRADE-2.5`: https://github.com/symfony/symfony/blob/2.5/UPGRADE-2.5.md
-.. _`UPGRADE-2.6`: https://github.com/symfony/symfony/blob/2.6/UPGRADE-2.6.md
-.. _`Symfony Repository`: https://github.com/symfony/symfony
-.. _`Composer Package Versions`: https://getcomposer.org/doc/01-basic-usage.md#package-versions
-.. _`version constraints`: https://getcomposer.org/doc/01-basic-usage.md#package-versions
\ No newline at end of file
diff --git a/redirection_map b/redirection_map
index 2d782f924fb..e325f7896a9 100644
--- a/redirection_map
+++ b/redirection_map
@@ -23,3 +23,4 @@
 /cookbook/console/generating_urls /cookbook/console/sending_emails
 /components/yaml /components/yaml/introduction
 /components/templating /components/templating/introduction
+/cookbook/upgrading /cookbook/upgrade/index

From 2b0aee32f97638a80301bf1b5ccfa3593bfbc736 Mon Sep 17 00:00:00 2001
From: WouterJ <waldio.webdesign@gmail.com>
Date: Tue, 10 Mar 2015 11:03:01 +0100
Subject: [PATCH 2/7] Fix little title case mistake

---
 contributing/code/bc.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/bc.rst b/contributing/code/bc.rst
index 2d2a5f9cc94..95613bd1763 100644
--- a/contributing/code/bc.rst
+++ b/contributing/code/bc.rst
@@ -1,4 +1,4 @@
-Our backwards Compatibility Promise
+Our Backwards Compatibility Promise
 ===================================
 
 Ensuring smooth upgrades of your projects is our first priority. That's why

From 300e8ab381066e2e57c8124190aeacb12c7f9aef Mon Sep 17 00:00:00 2001
From: WouterJ <waldio.webdesign@gmail.com>
Date: Tue, 10 Mar 2015 11:03:41 +0100
Subject: [PATCH 3/7] Added new recipe on upgrading a major version

---
 cookbook/map.rst.inc                         |   7 +-
 cookbook/upgrade/index.rst                   |   1 +
 cookbook/upgrade/major_version.rst           | 112 +++++++++++++++++++
 images/cookbook/deprecations-in-profiler.png | Bin 0 -> 46418 bytes
 4 files changed, 117 insertions(+), 3 deletions(-)
 create mode 100644 cookbook/upgrade/major_version.rst
 create mode 100644 images/cookbook/deprecations-in-profiler.png

diff --git a/cookbook/map.rst.inc b/cookbook/map.rst.inc
index 92bc715cee4..e268cecbe39 100644
--- a/cookbook/map.rst.inc
+++ b/cookbook/map.rst.inc
@@ -201,10 +201,11 @@
   * (email) :doc:`/cookbook/email/testing`
   * (form) :doc:`/cookbook/form/unit_testing`
 
-* :doc:`/cookbook/upgrading/index`
+* :doc:`/cookbook/upgrade/index`
 
-  * :doc:`/cookbook/upgrading/patch_version`
-  * :doc:`/cookbook/upgrading/minor_version`
+  * :doc:`/cookbook/upgrade/patch_version`
+  * :doc:`/cookbook/upgrade/minor_version`
+  * :doc:`/cookbook/upgrade/major_version`
 
 * :doc:`/cookbook/validation/index`
 
diff --git a/cookbook/upgrade/index.rst b/cookbook/upgrade/index.rst
index fe4aeca3b4e..b943f2ae32a 100644
--- a/cookbook/upgrade/index.rst
+++ b/cookbook/upgrade/index.rst
@@ -15,3 +15,4 @@ There are three types of upgrades, all needing a little different preparation:
 
     /cookbook/upgrade/patch_version
     /cookbook/upgrade/minor_version
+    /cookbook/upgrade/major_version
diff --git a/cookbook/upgrade/major_version.rst b/cookbook/upgrade/major_version.rst
new file mode 100644
index 00000000000..6428c20159f
--- /dev/null
+++ b/cookbook/upgrade/major_version.rst
@@ -0,0 +1,112 @@
+.. index::
+    single: Upgrading; Major Version
+
+Upgrading a Major Version (e.g. 2.7.0 to 3.0.0)
+===============================================
+
+Every few years, Symfony releases a new major version release (the first number
+changes). These releases are the trickiest to upgrade, as they are allowed to
+contain BC breaks. However, Symfony tries to make this upgrade process as
+smooth as possible.
+
+This means that you can update most of your code before the major release is
+actually released. This is called making your code *future compatible*.
+
+There are a couple of steps to upgrading a major version:
+
+#. :ref:`Make your code deprecation free <upgrade-major-symfony-deprecations>`;
+#. :ref:`Update to the new major version via Composer <upgrade-major-symfony-composer>`.
+#. :ref:`Update your code to work with the new version <upgrade-major-symfony-after>`
+
+.. _upgrade-major-symfony-deprecations:
+
+1) Make your Code Deprecation Free
+----------------------------------
+
+During the lifecycle of a major release, new features are added and method
+signatures and public API usages are changed. However, minor versions should
+not contain any backwards compatibility changes. It is made sure that there is
+a so-called *backwards compatibility layer* (or BC layer). This means that the
+old API will still work, while the new feature is used internally. This BC
+layer is then marked as *deprecated*, indicating that it will be
+removed/changed in the future.
+
+The major version is the only time all existing BC layers are removed. The last
+minor version before a new major version (i.e. 2.7 is the last minor version of
+the 2 releases, 3.0 is the next version) will trigger deprecation notices when a
+BC layer is used.
+
+When visiting your application in the
+:doc:`dev environment </cookbook/configuration/environments>` in your browser,
+these notices are shown in the web dev toolbar:
+
+.. image:: /images/cookbook/deprecations-in-profiler.png
+
+Deprecations in PHPUnit
+~~~~~~~~~~~~~~~~~~~~~~~
+
+By default, PHPUnit will handle deprecation notices as real errors. This means
+that all tests are aborted because it uses a BC layer.
+
+To make sure this doesn't happen, you can install the PHPUnit bridge:
+
+.. code-block:: bash
+
+    $ composer require symfony/phpunit-bridge
+
+Now, your tests execute normally and a nice summary of the deprecation notices
+is displayed at the end of the test report:
+
+.. code-block:: text
+
+    $ phpunit
+    ...
+
+    OK (10 tests, 20 assertions)
+
+    Remaining deprecation notices (6)
+
+    The "request" service is deprecated and will be removed in 3.0. Add a typehint for
+    Symfony\Component\HttpFoundation\Request to your controller parameters to retrieve the
+    request instead: 6x
+        3x in PageAdminTest::testPageShow from Symfony\Cmf\SimpleCmsBundle\Tests\WebTest\Admin
+        2x in PageAdminTest::testPageList from Symfony\Cmf\SimpleCmsBundle\Tests\WebTest\Admin
+        1x in PageAdminTest::testPageEdit from Symfony\Cmf\SimpleCmsBundle\Tests\WebTest\Admin
+
+.. _upgrade-major-symfony-composer:
+
+2) Update to the New Major Version via Composer
+-----------------------------------------------
+
+If your code is deprecation free, you can update the Symfony library via
+Composer by modifying your ``composer.json`` file:
+
+.. code-block:: json
+
+    {
+        "...": "...",
+
+        "require": {
+            "symfony/symfony": "3.0.*",
+        },
+        "...": "...",
+    }
+
+Next, use Composer to download new versions of the libraries:
+
+.. code-block:: bash
+
+    $ composer update symfony/symfony
+
+.. include:: /cookbook/upgrade/_update_all_packages.rst.inc
+
+.. _upgrade-major-symfony-after:
+
+3) Update your Code to Work with the New Version
+------------------------------------------------
+
+There is a high chance that you're done now! However, the next major version
+*may* also contain new BC breaks as a BC layer is not always a possibility.
+Make sure you read the ``UPGRADE-X.0.md`` (where X is the new major version)
+included in the Symfony repository for any BC break that you need to be aware
+of.
diff --git a/images/cookbook/deprecations-in-profiler.png b/images/cookbook/deprecations-in-profiler.png
new file mode 100644
index 0000000000000000000000000000000000000000..7b32d59cb0532aa85f54612979d2b335ce363cac
GIT binary patch
literal 46418
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
Sl*5q?P*zZrFM0Ix?f(IHe0d1~

literal 0
HcmV?d00001


From 99c5075a6531f962dce504ed21a7c0fca00cc451 Mon Sep 17 00:00:00 2001
From: WouterJ <waldio.webdesign@gmail.com>
Date: Tue, 14 Apr 2015 12:13:04 +0200
Subject: [PATCH 4/7] Fix typo

---
 cookbook/upgrade/_update_all_packages.rst.inc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/cookbook/upgrade/_update_all_packages.rst.inc b/cookbook/upgrade/_update_all_packages.rst.inc
index 49d82e9fe12..b309e054327 100644
--- a/cookbook/upgrade/_update_all_packages.rst.inc
+++ b/cookbook/upgrade/_update_all_packages.rst.inc
@@ -13,4 +13,4 @@ this safely by running:
     non-Symfony libraries to new versions that contain backwards-compatibility
     breaking changes.
 
-.. _`versino constraints`: https://getcomposer.org/doc/01-basic-usage.md#package-versions
+.. _`version constraints`: https://getcomposer.org/doc/01-basic-usage.md#package-versions

From 55fcee9a898db5ee8ee382a235a97f9ed1738b67 Mon Sep 17 00:00:00 2001
From: WouterJ <waldio.webdesign@gmail.com>
Date: Sat, 23 May 2015 10:25:29 +0200
Subject: [PATCH 5/7] Applied comments

---
 cookbook/upgrade/_update_all_packages.rst.inc |  2 +-
 cookbook/upgrade/major_version.rst            | 10 ++++++----
 cookbook/upgrade/minor_version.rst            |  2 +-
 3 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/cookbook/upgrade/_update_all_packages.rst.inc b/cookbook/upgrade/_update_all_packages.rst.inc
index b309e054327..95e1c63f954 100644
--- a/cookbook/upgrade/_update_all_packages.rst.inc
+++ b/cookbook/upgrade/_update_all_packages.rst.inc
@@ -8,7 +8,7 @@ this safely by running:
 
 .. caution::
 
-    Beware, if you have some bad `version constraints`_ in your
+    Beware, if you have some unspecific `version constraints`_ in your
     ``composer.json`` (e.g. ``dev-master``), this could upgrade some
     non-Symfony libraries to new versions that contain backwards-compatibility
     breaking changes.
diff --git a/cookbook/upgrade/major_version.rst b/cookbook/upgrade/major_version.rst
index 6428c20159f..67dc641d14f 100644
--- a/cookbook/upgrade/major_version.rst
+++ b/cookbook/upgrade/major_version.rst
@@ -31,10 +31,12 @@ old API will still work, while the new feature is used internally. This BC
 layer is then marked as *deprecated*, indicating that it will be
 removed/changed in the future.
 
-The major version is the only time all existing BC layers are removed. The last
-minor version before a new major version (i.e. 2.7 is the last minor version of
-the 2 releases, 3.0 is the next version) will trigger deprecation notices when a
-BC layer is used.
+The major version is the only time all existing BC layers are removed. However,
+if you make sure you've fixed all deprecated usages in the last version of the
+previous major version, you should be able to upgrade to the new major version
+without problems. To help you with this, the last minor releases will trigger
+deprecated notices. For example, 2.7 and 2.8 trigger deprecated notices and if
+you do not have any notice while using 2.8, you can savely upgrade to 3.0.
 
 When visiting your application in the
 :doc:`dev environment </cookbook/configuration/environments>` in your browser,
diff --git a/cookbook/upgrade/minor_version.rst b/cookbook/upgrade/minor_version.rst
index 4a5a0fa023e..3fa2d58970a 100644
--- a/cookbook/upgrade/minor_version.rst
+++ b/cookbook/upgrade/minor_version.rst
@@ -45,7 +45,7 @@ Next, use Composer to download new versions of the libraries:
 
 .. _`upgrade-minor-symfony-code`:
 
-2) Updating Your Code to Work with the new Version
+2) Updating your Code to Work with the new Version
 --------------------------------------------------
 
 In theory, you should be done! However, you *may* need to make a few changes

From 31999dbab4d15f2fe7ed9f4d85eb05ec8f8c4ac2 Mon Sep 17 00:00:00 2001
From: WouterJ <waldio.webdesign@gmail.com>
Date: Mon, 25 May 2015 00:01:56 +0200
Subject: [PATCH 6/7] Fixes after review

---
 cookbook/upgrade/major_version.rst | 34 ++++++++++++++----------------
 cookbook/upgrade/minor_version.rst |  9 ++++----
 2 files changed, 21 insertions(+), 22 deletions(-)

diff --git a/cookbook/upgrade/major_version.rst b/cookbook/upgrade/major_version.rst
index 67dc641d14f..ddc1d271d07 100644
--- a/cookbook/upgrade/major_version.rst
+++ b/cookbook/upgrade/major_version.rst
@@ -24,23 +24,21 @@ There are a couple of steps to upgrading a major version:
 ----------------------------------
 
 During the lifecycle of a major release, new features are added and method
-signatures and public API usages are changed. However, minor versions should
-not contain any backwards compatibility changes. It is made sure that there is
-a so-called *backwards compatibility layer* (or BC layer). This means that the
-old API will still work, while the new feature is used internally. This BC
-layer is then marked as *deprecated*, indicating that it will be
-removed/changed in the future.
-
-The major version is the only time all existing BC layers are removed. However,
-if you make sure you've fixed all deprecated usages in the last version of the
-previous major version, you should be able to upgrade to the new major version
-without problems. To help you with this, the last minor releases will trigger
-deprecated notices. For example, 2.7 and 2.8 trigger deprecated notices and if
-you do not have any notice while using 2.8, you can savely upgrade to 3.0.
-
-When visiting your application in the
-:doc:`dev environment </cookbook/configuration/environments>` in your browser,
-these notices are shown in the web dev toolbar:
+signatures and public API usages are changed. However,
+:doc:`minor versions </cookbook/upgrade/minor_version` should not contain any
+backwards compatibility changes. To accomplish this, the "old" (e.g. functions,
+classes, etc) code still works, but is marked as *deprecated*, indicating that
+it will be removed/changed in the future and that you should stop using it.
+
+When the major version is released (e.g. 3.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.
+2.8.*), you should be able to upgrade without a problem.
+
+To help you with this, the last minor releases will trigger deprecated notices.
+For example, 2.7 and 2.8 trigger deprecated notices. When visiting your
+application in the :doc:`dev environment </cookbook/configuration/environments>`
+in your browser, these notices are shown in the web dev toolbar:
 
 .. image:: /images/cookbook/deprecations-in-profiler.png
 
@@ -107,7 +105,7 @@ Next, use Composer to download new versions of the libraries:
 3) Update your Code to Work with the New Version
 ------------------------------------------------
 
-There is a high chance that you're done now! However, the next major version
+There is a good chance that you're done now! However, the next major version
 *may* also contain new BC breaks as a BC layer is not always a possibility.
 Make sure you read the ``UPGRADE-X.0.md`` (where X is the new major version)
 included in the Symfony repository for any BC break that you need to be aware
diff --git a/cookbook/upgrade/minor_version.rst b/cookbook/upgrade/minor_version.rst
index 3fa2d58970a..55b63bb0580 100644
--- a/cookbook/upgrade/minor_version.rst
+++ b/cookbook/upgrade/minor_version.rst
@@ -53,11 +53,12 @@ to your code to get everything working. Additionally, some features you're
 using might still work, but might now be deprecated. While that's just fine,
 if you know about these deprecations, you can start to fix them over time.
 
-Every version of Symfony comes with an UPGRADE file included in the Symfony
-directory that describes these changes. If you follow the instructions in the
-document and update your code accordingly, it should be save to update in the
-future.
+Every version of Symfony comes with an UPGRADE file (e.g. `UPGRADE-2.7.md`_)
+included in the Symfony directory that describes these changes. If you follow
+the instructions in the document and update your code accordingly, it should be
+safe to update in the future.
 
 These documents can also be found in the `Symfony Repository`_.
 
 .. _`Symfony Repository`: https://github.com/symfony/symfony
+.. _`UPGRADE-2.7.md`: https://github.com/symfony/symfony/blob/2.7/UPGRADE-2.7.md

From 604ccabbc7c7ab849059c87f61f1dafe7d8262a9 Mon Sep 17 00:00:00 2001
From: Wouter J <waldio.webdesign@gmail.com>
Date: Mon, 25 May 2015 10:44:13 +0200
Subject: [PATCH 7/7] Fix formatting error

---
 cookbook/upgrade/major_version.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/cookbook/upgrade/major_version.rst b/cookbook/upgrade/major_version.rst
index ddc1d271d07..10fcafbbf83 100644
--- a/cookbook/upgrade/major_version.rst
+++ b/cookbook/upgrade/major_version.rst
@@ -25,7 +25,7 @@ There are a couple of steps to upgrading a major version:
 
 During the lifecycle of a major release, new features are added and method
 signatures and public API usages are changed. However,
-:doc:`minor versions </cookbook/upgrade/minor_version` should not contain any
+:doc:`minor versions </cookbook/upgrade/minor_version>` should not contain any
 backwards compatibility changes. To accomplish this, the "old" (e.g. functions,
 classes, etc) code still works, but is marked as *deprecated*, indicating that
 it will be removed/changed in the future and that you should stop using it.