From 58d716f51fda78ec793975eea5876691aa576b2c Mon Sep 17 00:00:00 2001
From: alkatar21 <61387986+alkatar21@users.noreply.github.com>
Date: Tue, 31 May 2022 10:22:17 +0200
Subject: [PATCH] [Docs] Fix local extensions documentation

---
 docs/advanced/local_extensions.rst | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/docs/advanced/local_extensions.rst b/docs/advanced/local_extensions.rst
index 9a3d4b940..d7eba4603 100644
--- a/docs/advanced/local_extensions.rst
+++ b/docs/advanced/local_extensions.rst
@@ -3,7 +3,7 @@
 Local Extensions
 ----------------
 
-*New in Cookiecutter X.x*
+*New in Cookiecutter 2.1*
 
 A template may extend the Cookiecutter environment with local extensions.
 These can be part of the template itself, providing it with more sophisticated custom tags and filters.
@@ -18,13 +18,10 @@ To do so, a template author must specify the required extensions in ``cookiecutt
         "_extensions": ["local_extensions.FoobarExtension"]
     }
 
-This example assumes that a ``local_extensions`` folder (python module) exists in the template root.
-It will contain a ``main.py`` file, containing the following (for instance):
+This example uses a simple module ``local_extensions.py`` which exists in the template root, containing the following (for instance):
 
 .. code-block:: python
 
-    # -*- coding: utf-8 -*-
-
     from jinja2.ext import Extension
 
 
@@ -48,8 +45,6 @@ It's likely that we'd only want to register a single function as a filter. For t
 
 .. code-block:: python
 
-    # -*- coding: utf-8 -*-
-
     from cookiecutter.utils import simple_filter
 
 
@@ -58,3 +53,7 @@ It's likely that we'd only want to register a single function as a filter. For t
         return v * 2
 
 This snippet will achieve the exact same result as the previous one.
+
+For complex use cases, a python module ``local_extensions`` (a folder with an ``__init__.py``) can also be created in the template root.
+Here, for example, a module ``main.py`` would have to export all extensions with ``from .main import FoobarExtension, simplefilterextension`` or ``from .main import *`` in the ``__init__.py``.
+