From 2412bf2f1a2e453fc5917d3021140ffe0914c6e9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 14 Jun 2019 09:08:42 +0200
Subject: [PATCH] Reworded the Setup article about the local Symfony server

---
 setup.rst | 27 ++++++++++++++++-----------
 1 file changed, 16 insertions(+), 11 deletions(-)

diff --git a/setup.rst b/setup.rst
index f2bbb1396cb..5887f946b70 100644
--- a/setup.rst
+++ b/setup.rst
@@ -37,25 +37,25 @@ In other words, your new app is ready!
 Running your Symfony Application
 --------------------------------
 
-On production, you should use a web server like Nginx or Apache
-(see :doc:`configuring a web server to run Symfony </setup/web_server_configuration>`).
-But for development, it's convenient to use the :doc:`Symfony Local Web Server <setup/symfony_server>`.
+On production, you should use a web server like Nginx or Apache (see
+:doc:`configuring a web server to run Symfony </setup/web_server_configuration>`).
+But for development, it's more convenient to use the
+:doc:`Symfony Local Web Server <setup/symfony_server>`.
 
-.. note::
+This local server provides support for HTTP/2, TLS/SSL, automatic generation of
+security certificates and many other features. It works with any PHP application,
+not only Symfony projects, so it's a very useful development tool.
 
-    If you want to use a virtual machine (VM) with Vagrant, check out
-    :doc:`Homestead </setup/homestead>`.
-
-Move into your new project and start the server:
+Once installed, move into your new project and start the local web server:
 
 .. code-block:: terminal
 
     $ cd my-project
     $ symfony server:start
 
-Open your browser and navigate to ``http://localhost:8000/``. If everything is working,
-you'll see a welcome page. Later, when you are finished working, stop the server
-by pressing ``Ctrl+C`` from your terminal.
+Open your browser and navigate to ``http://localhost:8000/``. If everything is
+working, you'll see a welcome page. Later, when you are finished working, stop
+the server by pressing ``Ctrl+C`` from your terminal.
 
 .. tip::
 
@@ -63,6 +63,11 @@ by pressing ``Ctrl+C`` from your terminal.
     some technical requirements. Use the :doc:`Symfony Requirements Checker </reference/requirements>`
     tool to make sure your system is set up.
 
+.. note::
+
+    If you want to use a virtual machine (VM) with Vagrant, check out
+    :doc:`Homestead </setup/homestead>`.
+
 .. tip::
 
     If you're using a VM, you may need to tell the server to bind to all IP addresses: