From 0c624b58e1e380bafdfc25b8ad357e5c96b94274 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 27 Jul 2018 16:17:08 +0200
Subject: [PATCH] Improve the docs about custom form theme config

---
 form/form_themes.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/form/form_themes.rst b/form/form_themes.rst
index c312b586298..0cda20b727f 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -179,6 +179,7 @@ file:
         # app/config/config.yml
         twig:
             form_themes:
+                - '...'
                 - 'form/fields.html.twig'
             # ...
 
@@ -194,6 +195,7 @@ file:
                 http://symfony.com/schema/dic/twig http://symfony.com/schema/dic/twig/twig-1.0.xsd">
 
             <twig:config>
+                <twig:theme>...</twig:theme>
                 <twig:theme>form/fields.html.twig</twig:theme>
                 <!-- ... -->
             </twig:config>
@@ -204,11 +206,17 @@ file:
         // app/config/config.php
         $container->loadFromExtension('twig', array(
             'form_themes' => array(
+                '...',
                 'form/fields.html.twig',
             ),
             // ...
         ));
 
+.. note::
+
+    Add your custom theme at the end of the ``form_themes`` list because each
+    theme overrides all the previous themes.
+
 Any blocks inside the ``fields.html.twig`` template are now used globally
 to define form output.