@@ -49,14 +49,14 @@ Example
49
49
Code Examples
50
50
-------------
51
51
52
+ * The code follows the :doc: `Symfony Coding Standards </contributing/code/standards >`
53
+ as well as the `Twig Coding Standards `_;
52
54
* The code examples should look real for a web application context. Avoid abstract
53
- and puerile examples (``foo ``, ``bar ``, ``demo ``, etc.);
54
- * Use ``Acme `` when the code requires to explicit a vendor name;
55
- * The code should follow the :doc: `Symfony Best Practices </best_practices >`.
55
+ or puerile examples (``foo ``, ``bar ``, ``demo ``, etc.);
56
+ * The code should follow the :doc: `Symfony Best Practices </best_practices/introduction >`.
56
57
Unless the example requires to use a custom bundle, make sure to always use the
57
58
``AppBundle `` bundle to store your code;
58
- * The code follows the :doc: `Symfony Coding Standards </contributing/code/standards >`
59
- as well as the `Twig Coding Standards `_;
59
+ * Use ``Acme `` when the code requires a vendor name;
60
60
* To avoid horizontal scrolling on code blocks, we prefer to break a line
61
61
correctly if it crosses the 85th character;
62
62
* When you fold one or more lines of code, place ``... `` in a comment at the point
@@ -145,13 +145,9 @@ English Language Standards
145
145
--------------------------
146
146
147
147
Symfony documentation uses the United States English dialect, commonly called
148
- `American English `_.
149
-
150
- Unlike most popular languages, the English language doesn't have a central
151
- language authority and there is no official grammar or dictionary. Symfony
152
- documentation uses the `American English Oxford Dictionary `_ to resolve disputes
153
- over common words. In case a technical word isn't included in the dictionary yet,
154
- Symfony Documentation maintainers will decide over the disputes.
148
+ `American English `_. Disputes over vocabulary will always be resolved using the
149
+ `American English Oxford Dictionary `_ reference. Disputes over neologisms not
150
+ included yet in the dictionary will be resolved by Symfony Documentation maintainers.
155
151
156
152
In addition, documentation contents should follow these rules:
157
153
0 commit comments