Merge branch '4.0'

* 4.0:
  Mention the skeleton project when creating projects
  Include a reference to the namespace option
  Server version should be specified as a string
  Update setup.rst
  Event form modifications improvements
  Add createdAt property + setter and getter

Author: javiereguiluz

components/serializer.rst

@@ -70,6 +70,7 @@ exists in your project::
         private $age;
         private $name;
         private $sportsman;
+        private $createdAt;
 
         // Getters
         public function getName()
@@ -82,6 +83,11 @@ exists in your project::
             return $this->age;
         }
 
+        public function getCreatedAt()
+        {
+            return $this->createdAt;
+        }
+
         // Issers
         public function isSportsman()
         {
@@ -103,6 +109,11 @@ exists in your project::
         {
             $this->sportsman = $sportsman;
         }
+
+        public function setCreatedAt($createdAt)
+        {
+            $this->createdAt = $createdAt;
+        }
     }
 
 Now, if you want to serialize this object into JSON, you only need to

form/dynamic_form_modification.rst

@@ -502,6 +502,11 @@ callbacks only because in two different scenarios, the data that you can use is
 available in different events. Other than that, the listeners always perform
 exactly the same things on a given form.
 
+.. tip::
+
+    The ``FormEvents::POST_SUBMIT`` event does not allow to modify the form
+    the listener is bound to, but it allows to modify its parent.
+
 One piece that is still missing is the client-side updating of your form after
 the sport is selected. This should be handled by making an AJAX call back to
 your application. Assume that you have a sport meetup creation controller::

form/events.rst

@@ -219,7 +219,8 @@ View data        Normalized data transformed using a view transformer
 
 .. caution::
 
-    At this point, you cannot add or remove fields to the form.
+    At this point, you cannot add or remove fields to the current form and its
+    children.
 
 .. sidebar:: ``FormEvents::POST_SUBMIT`` in the Form component
 

reference/configuration/doctrine.rst

@@ -134,18 +134,21 @@ Full Default Configuration
                             port:                 ~
                             instance_class:       ~
                             class:                ~
+                            namespace:            ~
                         metadata_cache_driver:
                             type:                 array # Required
                             host:                 ~
                             port:                 ~
                             instance_class:       ~
                             class:                ~
+                            namespace:            ~
                         result_cache_driver:
                             type:                 array # Required
                             host:                 ~
                             port:                 ~
                             instance_class:       ~
                             class:                ~
+                            namespace:            ~
                         connection:           ~
                         class_metadata_factory_name:  Doctrine\ORM\Mapping\ClassMetadataFactory
                         default_repository_class:  Doctrine\ORM\EntityRepository
@@ -318,7 +321,7 @@ The following block shows all possible configuration keys:
                 charset:              UTF8
                 logging:              '%kernel.debug%'
                 platform_service:     App\DBAL\MyDatabasePlatformService
-                server_version:       5.6
+                server_version:       '5.6'
                 mapping_types:
                     enum: string
                 types:
@@ -369,6 +372,11 @@ The following block shows all possible configuration keys:
     to find your PostgreSQL version and ``mysql -V`` to get your MySQL
     version).
 
+    Always wrap the server version number with quotes to parse it as a string
+    instead of a float number. Otherwise, the floating-point representation
+    issues can make your version be considered a different number (e.g. ``5.6``
+    will be rounded as ``5.5999999999999996447286321199499070644378662109375``).
+
     If you don't define this option and you haven't created your database
     yet, you may get ``PDOException`` errors because Doctrine will try to
     guess the database server version automatically and none is available.

setup.rst

@@ -23,6 +23,16 @@ This will create a new ``my-project`` directory, download some dependencies into
 it and even generate the basic directories and files you'll need to get started.
 In other words, your new app is ready!
 
+.. tip::
+
+    The ``website-skeleton`` is optimized for traditional web applications. If
+    you are building microservices, console applications or APIs, consider
+    using the much simpler ``skeleton`` project:
+
+    .. code-block:: terminal
+
+        $ composer create-project symfony/skeleton my-project
+
 Running your Symfony Application
 --------------------------------
 
@@ -112,7 +122,7 @@ vulnerability. Run this command to install it in your application:
 .. code-block:: terminal
 
     $ cd my-project/
-    $ composer require sec-checker
+    $ composer require sec-checker --dev
 
 From now on, this utility will be run automatically whenever you install or
 update any dependency in the application. If a dependency contains a vulnerability,