Add upgrade guide for 1.7

CHANGELOG-1.7.md

@@ -1,6 +1,6 @@
 # CHANGELOG FOR `1.7.X`
 
-## v1.7.0 (2019-02-28)
+## v1.7.0-RC.1 (2019-03-01)
 
 #### Details
 

UPGRADE-1.7.md

@@ -1,37 +1,61 @@
 # UPGRADE FROM `v1.6.X` TO `v1.7.0`
 
-Require upgraded Sylius version using Composer:
+1. Require upgraded Sylius version using Composer:
 
-```bash
-composer require sylius/sylius:~1.7.0
-```
+    ```bash
+    composer require sylius/sylius:~1.7.0
+    ```
+   
+   You might need to adjust your `config.platform.php` setting in `composer.json`, because Sylius 1.7 requires PHP 7.3 or higher.
 
-Update your `package.json` in order to add `chart.js` and `slick-carousel` : 
+2. Update your `package.json` in order to add new dependencies: 
 
-```diff
-{
-  "dependencies": {
-    "babel-polyfill": "^6.26.0",
-+   "chart.js": "^2.9.3",
-    "jquery": "^3.4.0",
-    "jquery.dirtyforms": "^2.0.0",
-    "lightbox2": "^2.9.0",
-    "semantic-ui-css": "^2.2.0",
-+   "slick-carousel": "^1.8.1"
-  },
-  ...
-}
-```
+    ```diff
+    {
+      "dependencies": {
+    +   "chart.js": "^2.9.3",
+    +   "slick-carousel": "^1.8.1",
+      },
+      "devDependencies": {
+    +   "@symfony/webpack-encore": "^0.28.0",
+    +   "sass-loader": "^7.0.1",
+      }
+      ...
+    }
+    ```
+   
+   Run `yarn install && yarn build` to use them.
 
-You may need to remove `SonataCoreBundle` from your list of used bundles in `config/bundles.php`(if you are not using it explicitly):
+3. Remove `SonataCoreBundle` from your list of used bundles in `config/bundles.php` if you are not using it apart from Sylius:
 
-```diff
-    winzou\Bundle\StateMachineBundle\winzouStateMachineBundle::class => ['all' => true],
--   Sonata\CoreBundle\SonataCoreBundle::class => ['all' => true],
-    Sonata\BlockBundle\SonataBlockBundle::class => ['all' => true],
-```
+    ```diff
+    -   Sonata\CoreBundle\SonataCoreBundle::class => ['all' => true],
+    ```
+    
+    You should remove `config/packages/sonata_core.yaml` as well.
+    
+4. Remove `config/packages/twig_extensions.yaml` file if you are not using the `twig/extensions` package in your application.
+    
+5. Add the following snippet to `config/packages/twig.yaml` to enable `Twig\Extra\Intl\IntlExtension`:
 
-And you should remove `config/packages/sonata_core.yaml` as well.
+    ```yaml
+    services:
+        _defaults:
+            public: false
+            autowire: true
+            autoconfigure: true
+            
+        Twig\Extra\Intl\IntlExtension: ~
+   ```
+   
+6. Copy migration files into `src/Migrations`:
+
+    - [Version20191119131635.php](https://raw.githubusercontent.com/Sylius/Sylius-Standard/1.7/src/Migrations/Version20191119131635.php)
+    - [Version20200301170604.php](https://raw.githubusercontent.com/Sylius/Sylius-Standard/1.7/src/Migrations/Version20200301170604.php)
+    
+    Run `bin/console doctrine:migrations:migrate` to use them.
+    
+7. Clear cache by `bin/console cache:clear`.
 
 ## Template events