Include the version option at the end

Author: javiereguiluz

best_practices/creating-the-project.rst

@@ -31,15 +31,15 @@ to create files and execute the following commands:
 .. code-block:: terminal
 
     $ cd projects/
-    $ symfony new --version=3.4 blog
+    $ symfony new blog --version=3.4
 
 **Windows systems**:
 
 .. class:: command-windows
 .. code-block:: terminal
 
     > cd projects/
-    > php symfony new --version=3.4 blog
+    > php symfony new blog --version=3.4
 
 .. note::
 

setup.rst

@@ -67,7 +67,7 @@ with the ``new`` command:
 
 .. code-block:: terminal
 
-    $ symfony new --version=3.4 my_project_name
+    $ symfony new my_project_name --version=3.4
 
 This command creates a new directory called ``my_project_name/`` that contains
 an empty project based on the most recent stable Symfony version available. In
@@ -111,15 +111,18 @@ In case your project needs to be based on a specific Symfony version, use the
 .. code-block:: terminal
 
     # use the most recent version in any Symfony branch
-    $ symfony new --version=3.3 my_project_name
-    $ symfony new --version=3.4 my_project_name
+    $ symfony new my_project_name --version=3.3
+    $ symfony new my_project_name --version=3.4
 
     # use a specific Symfony version
-    $ symfony new --version=3.3.10 my_project_name
-    $ symfony new --version=3.4.5 my_project_name
+    $ symfony new my_project_name --version=3.3.10
+    $ symfony new my_project_name --version=3.4.5
 
     # use the most recent 'lts' version (Long Term Support version)
-    $ symfony new --version=lts my_project_name
+    $ symfony new my_project_name --version=lts
+
+    # use the 'next' Symfony version to be released (still in development)
+    $ symfony new my_project_name --version=next
 
 Each version has its *own* documentation, which you can select on any documentation
 page.

setup/symfony_server.rst

@@ -364,24 +364,25 @@ commands from the Symfony server:
 .. code-block:: terminal
 
     # creates a new project based on symfony/skeleton
-    $ symfony new --version=3.4 my_project_name
+    $ symfony new my_project_name --version=3.4
 
     # creates a new project based on symfony/website-skeleton
-    $ symfony new --version=3.4 --full my_project_name
+    $ symfony new my_project_name --version=3.4 --full
 
     # creates a new project based on the Symfony Demo application
-    $ symfony new --version=3.4 --demo my_project_name
+    $ symfony new my_project_name --version=3.4 --demo
 
 You can create a project depending on a **development** version as well (note
 that Composer will also set the stability to ``dev`` for all root dependencies):
 
 .. code-block:: terminal
 
-    # creates a new project based on Symfony's master branch
-    $ symfony new --version=dev-master my_project_name
+    # creates a new project based on Symfony's master branch (both are equivalent)
+    $ symfony new my_project_name --version=dev-master
+    $ symfony new my_project_name --version=next
 
     # creates a new project based on Symfony's 4.3 dev branch
-    $ symfony new --version=4.3.x-dev my_project_name
+    $ symfony new my_project_name --version=4.3.x-dev
 
 .. _`symfony.com/download`: https://symfony.com/download
 .. _`symfony/cli`: https://github.com/symfony/cli