bug #13633 [UPGRADE] Add more details about PHP, mocker container and…

… api platform folder (lchrusciel)

This PR was merged into the 1.11 branch.

Discussion
----------

| Q               | A
| --------------- | -----
| Branch?         | 1.11
| Bug fix?        | yes
| New feature?    | no
| BC breaks?      | no
| Deprecations?   | no
| Related tickets | 
| License         | MIT

<!--
 - Bug fixes must be submitted against the 1.10 or 1.11 branch(the lowest possible)
 - Features and deprecations must be submitted against the master branch
 - Make sure that the correct base branch is set

 To be sure you are not breaking any Backward Compatibilities, check the documentation:
 https://docs.sylius.com/en/latest/book/organization/backward-compatibility-promise.html
-->


Commits
-------

0eab28c [UPGRADE] Add more details about PHP, mocker container and api platform folder
63859a5 [UPGRADE] Semantical adjustments

UPGRADE-1.11.md

@@ -1,5 +1,16 @@
 # UPGRADE FROM `v1.10.X` TO `v1.11.0`
 
+## Preconditions
+
+### PHP8.0 support
+
+Sylius v1.11 comes with bump of minimal dependencies of PHP to v8.0. We strongly advice to make upgrade process step by step,
+so it is highly recommended updating your PHP version being still on Sylius v1.10, as it is supporting both PHP7.4 and PHP8.0.
+
+After ensuring, that previous step succeed, you may move forward to the Sylius v1.11 update.
+
+## Main update
+
 ### "pagerfanta/pagerfanta" semantic_ui_translated removed
 
 The `pagination.html.twig` has been changed to use the Twig view.
@@ -34,10 +45,20 @@ This obvious dev dependency was part of Sylius requirements. In 1.11 we've moved
      }
 ```
 
+If you were using MockerContainer in your app, you should also execute the following command:
+
+```bash
+composer req --dev polishsymfonycommunity/symfony-mocker-container
+```
+
 ### Drop support for PHP 7.4
 
 Due to the drop of support PHP `7.4` Sylius also will not support it since version `1.11`.
 
+### API Platform required folders
+
+If you don't already have, add an empty directory `api_platform` in your `config` directory and customize there any API resources.
+
 ### Potential BC-breaks
 
 #### State machine callbacks

UPGRADE-API-1.11.md

@@ -1,6 +1,4 @@
 # UPGRADE FROM `v1.10.X` TO `v1.11.0`
-
-1. If you don't already have, add an empty directory `api_platform` in your `config` directory and customize there any API resources.
 
 1. The product images should have a proper prefix (`/media/image/`) added to the path, so the images could be resolved. 
    This is now done out of the box and response of `Product Image` resource is now: