symfony
diff --git a/‎contributing/documentation/standards.rst
Copy file name to clipboardExpand all lines: contributing/documentation/standards.rst
+17Lines changed: 17 additions & 0 deletions b/‎contributing/documentation/standards.rst
Copy file name to clipboardExpand all lines: contributing/documentation/standards.rst
+17Lines changed: 17 additions & 0 deletions
@@ -81,6 +81,23 @@ Configuration examples should show all supported formats using
 * **Validation**: YAML, Annotations, XML, PHP
 * **Doctrine Mapping**: Annotations, YAML, XML, PHP
 
+Files and Directories
+~~~~~~~~~~~~~~~~~~~~~
+
+* When referencing directories, always add a trailing slash to avoid confusions
+  with regular files (e.g. *"execute the ``console`` script located at the ``app/``
+  directory"*).
+* You should include a leading dot in every file extension (e.g. *"``.ini`` files
+  are very limited compared to ``.xml`` files"*).
+* When you list a Symfony file/directory hierarchy, use ``your-project/`` as the
+  top level directory. E.g.
+
+      your-project/
+      ├─ app/
+      ├─ src/
+      ├─ vendor/
+      └─ ...
+
 Example
 ~~~~~~~