symfony
diff --git a/‎best_practices/forms.rst
Lines changed: 7 additions & 1 deletion b/‎best_practices/forms.rst
Lines changed: 7 additions & 1 deletion
diff --git a/‎book/validation.rst
Lines changed: 4 additions & 4 deletions b/‎book/validation.rst
Lines changed: 4 additions & 4 deletions
diff --git a/‎contributing/code/_api_tagging.rst.inc
Lines changed: 0 additions & 7 deletions b/‎contributing/code/_api_tagging.rst.inc
Lines changed: 0 additions & 7 deletions
diff --git a/‎contributing/code/bc.rst
Lines changed: 0 additions & 4 deletions b/‎contributing/code/bc.rst
Lines changed: 0 additions & 4 deletions
diff --git a/‎contributing/code/standards.rst
Lines changed: 17 additions & 1 deletion b/‎contributing/code/standards.rst
Lines changed: 17 additions & 1 deletion
diff --git a/‎cookbook/console/index.rst
Lines changed: 1 addition & 0 deletions b/‎cookbook/console/index.rst
Lines changed: 1 addition & 0 deletions
@@ -47,11 +47,17 @@ form in its own PHP class::
         }
     }
 
+.. best-practice::
+
+    Put the form type classes in the ``AppBundle\Form`` namespace, unless you
+    use other custom form classes like data transformers.
+
 To use the class, use ``createForm`` and pass the fully qualified class name::
 
-    use AppBundle\Form\PostType;
     // ...
+    use AppBundle\Form\PostType;
 
+    // ...
     public function newAction(Request $request)
     {
         $post = new Post();
 
@@ -644,7 +644,7 @@ this method must return ``true``:
         AppBundle\Entity\Author:
             getters:
                 passwordLegal:
-                    - 'True': { message: 'The password cannot match your first name' }
+                    - 'IsTrue': { message: 'The password cannot match your first name' }
 
     .. code-block:: xml
 
@@ -656,7 +656,7 @@ this method must return ``true``:
 
             <class name="AppBundle\Entity\Author">
                 <getter property="passwordLegal">
-                    <constraint name="True">
+                    <constraint name="IsTrue">
                         <option name="message">The password cannot match your first name</option>
                     </constraint>
                 </getter>
@@ -954,7 +954,7 @@ username and the password are different only if all other validation passes
                 - Strict
             getters:
                 passwordLegal:
-                    - 'True':
+                    - 'IsTrue':
                         message: 'The password cannot match your username'
                         groups: [Strict]
             properties:
@@ -981,7 +981,7 @@ username and the password are different only if all other validation passes
                 </property>
 
                 <getter property="passwordLegal">
-                    <constraint name="True">
+                    <constraint name="IsTrue">
                         <option name="message">The password cannot match your username</option>
                         <option name="groups">
                             <value>Strict</value>
 
@@ -74,8 +74,6 @@ backwards compatibility promise:
 | Add a default value to an argument            | Yes                         |
 +-----------------------------------------------+-----------------------------+
 
-.. include:: _api_tagging.rst.inc
-
 Using our Classes
 ~~~~~~~~~~~~~~~~~
 
@@ -134,8 +132,6 @@ covered by our backwards compatibility promise:
 | Access a private property (via Reflection)    | No                          |
 +-----------------------------------------------+-----------------------------+
 
-.. include:: _api_tagging.rst.inc
-
 Working on Symfony Code
 -----------------------
 
 
@@ -50,6 +50,18 @@ example containing most features described below:
             $this->fooBar = $this->transformText($dummy);
         }
 
+        /**
+         * @return string
+         *
+         * @deprecated
+         */
+        public function someDeprecatedMethod()
+        {
+            @trigger_error(sprintf('The %s() method is deprecated since version 2.8 and will be removed in 3.0. Use Acme\Baz::someMethod() instead.', __METHOD__), E_USER_DEPRECATED);
+
+            return Baz::someMethod();
+        }
+
         /**
          * Transforms the input given as first argument.
          *
@@ -151,7 +163,11 @@ Structure
 * Use parentheses when instantiating classes regardless of the number of
   arguments the constructor has;
 
-* Exception message strings should be concatenated using :phpfunction:`sprintf`.
+* Exception and error message strings should be concatenated using :phpfunction:`sprintf`.
+
+* Calls to :phpfunction:`trigger_error` with type ``E_USER_DEPRECATED`` should be
+  switched to opt-in via ``@`` operator.
+  Read more at :ref:`contributing-code-conventions-deprecations`;
 
 Naming Conventions
 ------------------
 
@@ -6,6 +6,7 @@ Console
 
     console_command
     usage
+    style
     command_in_controller
     sending_emails
     logging
Original file line number	Diff line number	Diff line change
`@@ -47,11 +47,17 @@ form in its own PHP class::`
`47`	`47`	`}`
`48`	`48`	`}`
`49`	`49`
	`50`	`+.. best-practice::`
	`51`	`+`
	`52`	+ Put the form type classes in the ``AppBundle\Form`` namespace, unless you
	`53`	`+ use other custom form classes like data transformers.`
	`54`	`+`
`50`	`55`	To use the class, use ``createForm`` and pass the fully qualified class name::
`51`	`56`
`52`		`- use AppBundle\Form\PostType;`
`53`	`57`	`// ...`
	`58`	`+ use AppBundle\Form\PostType;`
`54`	`59`
	`60`	`+ // ...`
`55`	`61`	`public function newAction(Request $request)`
`56`	`62`	`{`
`57`	`63`	`$post = new Post();`