Deprecating support for legacy templates directory

yceruto · yceruto · commit 09bda818bf64 · 2018-10-16T14:50:47.000-04:00
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
@@ -267,13 +267,12 @@ has one file in it::
         }
     }
 
-Template files should live in the ``Resources/views/`` directory of whatever directory
-your *kernel* lives in. Since ``Kernel`` lives in ``src/``, this template lives
-at ``src/Resources/views/micro/random.html.twig``:
+Template files should live in the ``templates/`` directory at the root of your project.
+This template lives at ``templates/micro/random.html.twig``:
 
 .. code-block:: html+twig
 
-    <!-- src/Resources/views/micro/random.html.twig -->
+    <!-- templates/micro/random.html.twig -->
     <!DOCTYPE html>
     <html>
         <head>
@@ -311,13 +310,12 @@ this:
     ├─ public/
     |  └─ index.php
     ├─ src/
-    |  ├─ Kernel.php
     |  ├─ Controller
     |  |  └─ MicroController.php
-    │  └─ Resources
-    |     └─ views
-    |        └─ micro
-    |           └─ random.html.twig
+    |  └─ Kernel.php
+    ├─ templates/
+    |  └─ micro/
+    |     └─ random.html.twig
     ├─ var/
     |  ├─ cache/
     │  └─ log/
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
@@ -256,6 +256,10 @@ The default directory where Symfony will look for Twig templates.
 paths
 ~~~~~
 
+.. versionadded:: 4.2
+    The templates directory ``src/Resources/views/`` was deprecated in Symfony 4.2,
+    use the directory defined in the ``default_path`` option (``templates/`` by default).
+
 **type**: ``array`` **default**: ``null``
 
 This option defines the directories where Symfony will look for Twig templates
