bump: version 1.0.0rc1 → 1.0.0

CHANGELOG.md

@@ -1,202 +1,53 @@
-## 0.2.0a27 (2026-06-15)
+## 1.0.0 (2026-06-21)
 
 ### Feat
 
+- better customize vars documentation
 - can change the directory where documentation are placed + remove empty vars/main.yml file + better tests
-
-## 0.2.0a26 (2026-06-11)
-
-### Feat
-
 - leadership => sequence
-
-## 0.2.0a25 (2026-05-04)
-
-### Feat
-
 - gen doc for ansible output
 - add dot
-
-### Fix
-
-- update tests
-
-## 0.2.0a24 (2026-01-21)
-
-### Feat
-
 - doc rougail integration
-
-## 0.2.0a23 (2026-01-14)
-
-### Fix
-
-- yaml for all output format
-
-## 0.2.0a22 (2026-01-14)
-
-### Feat
-
 - gen doc of ansible type
-
-### Fix
-
-- update tests
-
-## 0.2.0a21 (2026-01-09)
-
-### Feat
-
 - add vars for an specified host
-
-## 0.2.0a20 (2025-12-30)
-
-### Feat
-
 - add doc
-
-### Fix
-
-- update tests
-
-## 0.2.0a19 (2025-12-22)
-
-### Feat
-
 - can sort variable per namespace
-
-## 0.2.0a18 (2025-11-21)
-
-### Feat
-
 - can remove namespace name in host vars
-
-## 0.2.0a17 (2025-11-06)
-
-### Feat
-
 - add some tests
-
-## 0.2.0a16 (2025-10-10)
-
-### Fix
-
-- update tests
-- tests
-
-## 0.2.0a15 (2025-10-03)
-
-### Fix
-
-- ansible in config is a family
-- tests for formatter
-
-## 0.2.0a14 (2025-09-29)
-
-### Feat
-
 - remove json.read_write option
 - default value for a calculated variable with an unknown optional variable
 - update tests for integer type
-
-## 0.2.0a13 (2025-09-22)
-
-### Fix
-
-- dictionary => structure
-
-## 0.2.0a12 (2025-09-10)
-
-### Fix
-
-- all group is not necesary
-
-## 0.2.0a11 (2025-09-08)
-
-### Fix
-
-- "all" group are now compose with host and we remove duplicated hostname
-
-## 0.2.0a10 (2025-07-04)
-
-### Feat
-
 - add ansible.export_warnings option
-
-## 0.2.0a9 (2025-06-18)
-
-### Fix
-
-- rougail separation
-
-## 0.2.0a8 (2025-05-12)
-
-### Fix
-
-- update tests
-- black
-
-## 0.2.0a7 (2025-05-02)
-
-### Fix
-
-- do not force use_data usage
-
-## 0.2.0a6 (2025-04-30)
-
-### Fix
-
-- remove negative_description support
-- update tests
-- better mandatory support in test
-
-## 0.2.0a5 (2025-04-09)
-
-### Fix
-
-- version
-
-## 0.2.0a4 (2025-04-01)
-
-### Fix
-
-- update tests
-
-## 0.2.0a3 (2025-02-17)
-
-### Fix
-
-- translation
-
-## 0.2.0a2 (2025-02-10)
-
-### Feat
-
 - output return status too
-
-## 0.2.0a1 (2025-01-02)
-
-### Fix
-
-- user data ansible is loaded before
-
-## 0.2.0a0 (2025-01-02)
-
-### Feat
-
 - add namespace_is_hostname option
 - add tests
 
-## 0.1.1a2 (2024-11-29)
-
-## 0.1.1a1 (2024-11-28)
-
 ### Fix
 
+- rougail dependencies
+- black
+- update french translation
+- update tests
+- yaml for all output format
+- update tests
+- update tests
+- update tests
+- tests
+- ansible in config is a family
+- tests for formatter
+- dictionary => structure
+- all group is not necesary
+- "all" group are now compose with host and we remove duplicated hostname
+- rougail separation
+- update tests
+- black
+- do not force use_data usage
+- remove negative_description support
+- update tests
+- better mandatory support in test
+- version
+- update tests
+- translation
+- user data ansible is loaded before
 - better errors support
-
-## 0.1.1a0 (2024-11-27)
-
-### Fix
-
 - first commit

locale/fr/LC_MESSAGES/rougail_output_ansible.po

@@ -5,8 +5,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2026-06-15 08:47+0200\n"
-"PO-Revision-Date: 2026-06-15 08:48+0200\n"
+"POT-Creation-Date: 2026-06-20 07:30+0200\n"
+"PO-Revision-Date: 2026-06-20 07:32+0200\n"
 "Last-Translator: \n"
 "Language-Team: \n"
 "Language: fr\n"
@@ -142,62 +142,68 @@ msgstr "Supprime le nom de l'espace de nom dans les vars de l'hôte"
 msgid "Displays warnings inside Ansible exportation datas"
 msgstr "Affiche les avertissements dans les données d'exportation Ansible"
 
-#: src/rougail/output_ansible/doc.py:101
+#: src/rougail/output_ansible/doc.py:102
 msgid "This repository contains the {0} Ansible collection."
 msgstr "Le dépôt contient la collection Ansible {0}."
 
-#: src/rougail/output_ansible/doc.py:108
+#: src/rougail/output_ansible/doc.py:109
 msgid "The group variables \"{0}\" - {1}"
 msgstr "Le groupe de variables \"{0}\" - {1}"
 
-#: src/rougail/output_ansible/doc.py:110
+#: src/rougail/output_ansible/doc.py:111
 msgid "The group variables {0}"
 msgstr "Le groupe de variables {0}"
 
-#: src/rougail/output_ansible/doc.py:115
+#: src/rougail/output_ansible/doc.py:116
 msgid "Variables"
 msgstr "Variables"
 
-#: src/rougail/output_ansible/doc.py:135
+#: src/rougail/output_ansible/doc.py:131
+msgid "Hidden variables can only be modified within a structure file."
+msgstr ""
+"Les variables cachées ne peuvent être modifiées que dans un fichier de "
+"structure."
+
+#: src/rougail/output_ansible/doc.py:136
 msgid "Usage"
 msgstr "Usage"
 
-#: src/rougail/output_ansible/doc.py:136
+#: src/rougail/output_ansible/doc.py:137
 msgid "Example Playbook with Rougail"
 msgstr "Exemple de playbook avec Rougail"
 
-#: src/rougail/output_ansible/doc.py:144
+#: src/rougail/output_ansible/doc.py:145
 msgid "Add to your structural file something like:"
 msgstr "Ajouter à votre fichier de structure quelque chose comme :"
 
-#: src/rougail/output_ansible/doc.py:148
+#: src/rougail/output_ansible/doc.py:149
 msgid "Customizing hidden variables in structure file:"
-msgstr "Variables personnalisées cachées dans les fichier de structure :"
+msgstr "Personnalisation des variables cachées dans le fichier de structure :"
 
-#: src/rougail/output_ansible/doc.py:151
+#: src/rougail/output_ansible/doc.py:152
 msgid "Do not forget to add Rougail structure file as Rougail types."
 msgstr ""
 "Ne pas oublier d'ajouter le fichier de structure Rougail comme types Rougail."
 
-#: src/rougail/output_ansible/doc.py:158
+#: src/rougail/output_ansible/doc.py:159
 msgid "For example you can add an YAML user data with something like:"
 msgstr ""
 "Par exemple vous pouvez ajouter une donnée utilisateur de type YAML avec "
 "quelque chose comme :"
 
-#: src/rougail/output_ansible/doc.py:160
+#: src/rougail/output_ansible/doc.py:161
 msgid "Add to your Play:"
 msgstr "Ajouter à votre Play :"
 
-#: src/rougail/output_ansible/doc.py:175
+#: src/rougail/output_ansible/doc.py:176
 msgid "Example Playbook without Rougail"
 msgstr "Exemple de Playbook sans Rougail"
 
-#: src/rougail/output_ansible/doc.py:176
+#: src/rougail/output_ansible/doc.py:177
 msgid "The variables will not be properly validated without Rougail."
 msgstr "Les variables ne seront pas validées correctement sans Rougail."
 
-#: src/rougail/output_ansible/doc.py:228
+#: src/rougail/output_ansible/doc.py:229
 msgid ""
 "Unable to find a Playbook in playbooks/ directory or a role in roles/ "
 "directory"

locale/rougail_output_ansible.pot

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2026-06-15 08:48+0200\n"
+"POT-Creation-Date: 2026-06-20 21:21+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -128,59 +128,7 @@ msgstr ""
 msgid "Displays warnings inside Ansible exportation datas"
 msgstr ""
 
-#: src/rougail/output_ansible/doc.py:101
-msgid "This repository contains the {0} Ansible collection."
-msgstr ""
-
-#: src/rougail/output_ansible/doc.py:108
-msgid "The group variables \"{0}\" - {1}"
-msgstr ""
-
-#: src/rougail/output_ansible/doc.py:110
-msgid "The group variables {0}"
-msgstr ""
-
-#: src/rougail/output_ansible/doc.py:115
-msgid "Variables"
-msgstr ""
-
-#: src/rougail/output_ansible/doc.py:135
-msgid "Usage"
-msgstr ""
-
-#: src/rougail/output_ansible/doc.py:136
-msgid "Example Playbook with Rougail"
-msgstr ""
-
-#: src/rougail/output_ansible/doc.py:144
-msgid "Add to your structural file something like:"
-msgstr ""
-
-#: src/rougail/output_ansible/doc.py:148
-msgid "Customizing hidden variables in structure file:"
-msgstr ""
-
-#: src/rougail/output_ansible/doc.py:151
-msgid "Do not forget to add Rougail structure file as Rougail types."
-msgstr ""
-
-#: src/rougail/output_ansible/doc.py:158
-msgid "For example you can add an YAML user data with something like:"
-msgstr ""
-
-#: src/rougail/output_ansible/doc.py:160
-msgid "Add to your Play:"
-msgstr ""
-
-#: src/rougail/output_ansible/doc.py:175
-msgid "Example Playbook without Rougail"
-msgstr ""
-
-#: src/rougail/output_ansible/doc.py:176
-msgid "The variables will not be properly validated without Rougail."
-msgstr ""
-
-#: src/rougail/output_ansible/doc.py:228
-msgid "Unable to find a Playbook in playbooks/ directory or a role in roles/ directory"
+#: src/rougail/output_ansible/doc.py:58
+msgid "{0} is not set as step.output"
 msgstr ""
 

pyproject.toml

@@ -4,7 +4,7 @@ requires = ["flit_core >=3.8.0,<4"]
 
 [project]
 name = "rougail.output_ansible"
-version = "0.2.0a27"
+version = "1.0.0"
 authors = [{name = "Emmanuel Garette", email = "gnunux@gnunux.info"}]
 readme = "README.md"
 description = "Rougail output ansible"
@@ -24,8 +24,8 @@ classifiers = [
 
 ]
 dependencies = [
-    "rougail >= 1.1,<2",
-    "rougail-output-json >= 0.1",
+    "rougail >= 1.2.0,<2",
+    "rougail-output-json >= 1.0.0,<2",
     "ansible",
 ]
 

src/rougail/output_ansible/__init__.py

@@ -15,6 +15,7 @@ details.
 You should have received a copy of the GNU Lesser General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
 """
+
 from .ansible import Inventory
 from .__version__ import __version__
 
@@ -34,25 +35,31 @@ class RougailOutputAnsible:
         self.kwargs = kwargs
 
     def run(self):
-        output = self.rougailconfig['ansible.output']
-        if output == 'doc':
+        output = self.rougailconfig["ansible.output"]
+        if output == "doc":
             from .doc import Doc
+
             data = Doc(self.config, rougailconfig=self.rougailconfig, **self.kwargs)
         else:
-            data = Inventory(self.config, rougailconfig=self.rougailconfig, **self.kwargs)
+            data = Inventory(
+                self.config, rougailconfig=self.rougailconfig, **self.kwargs
+            )
         return data.run()
 
     def print(self):
-        output = self.rougailconfig['ansible.output']
-        if output == 'doc':
+        output = self.rougailconfig["ansible.output"]
+        if output == "doc":
             from .doc import Doc
+
             data = Doc(self.config, rougailconfig=self.rougailconfig, **self.kwargs)
         else:
-            data = Inventory(self.config, rougailconfig=self.rougailconfig, **self.kwargs)
+            data = Inventory(
+                self.config, rougailconfig=self.rougailconfig, **self.kwargs
+            )
         return data.print()
 
 
 RougailOutput = RougailOutputAnsible
 
 
-__all__ = ("RougailOutputAnsible", '__version__')
+__all__ = ("RougailOutputAnsible", "__version__")

src/rougail/output_ansible/__version__.py

@@ -1 +1 @@
-__version__ = "0.2.0a27"
+__version__ = "1.0.0"

src/rougail/output_ansible/annotator.py

@@ -18,8 +18,10 @@ You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 """
+
 from rougail.error import DictConsistencyError
 from rougail.output_doc.i18n import _
+
 try:
     from rougail.output_doc.annotator import Annotator as AnnotatorDoc
 except:
@@ -27,40 +29,46 @@ except:
 
 
 if AnnotatorDoc:
+
     class Annotator(AnnotatorDoc):
         level = 96
 
         def __init__(self, *args):
-            super().__init__(*args, force_default_value=True)
-            return
-            host_namespace = self.objectspace.rougailconfig["ansible.inventory.host_namespace"]
-            namespaces = self.objectspace.parents["."]
-            if not namespaces:
-                msg = _("no namespace configured")
-                raise DictConsistencyError(msg, 300, [])
-            first_namespace = self.objectspace.paths[namespaces[0]]
-            if first_namespace.name != first_namespace.namespace:
-                msg = _("no namespace configured")
-                raise DictConsistencyError(msg, 301, first_namespace.xmlfiles)
-            if host_namespace not in namespaces:
-                msg = _('cannot find host namespace "{0}"').format(host_namespace)
-                raise DictConsistencyError(msg, 302, first_namespace.xmlfiles)
-            hostnames = f"{host_namespace}.hostnames"
-            if hostnames not in self.objectspace.parents[host_namespace]:
-                hosts = self.objectspace.paths[host_namespace]
-                msg = _('malformated host namespace "{0}", should have the "hostnames" key').format(host_namespace)
-                raise DictConsistencyError(msg, 303, hosts.xmlfiles)
-            for hostname in self.objectspace.parents[hostnames]:
-                hosts = self.objectspace.paths[hostname]
-                if hostname not in self.objectspace.families:
-                    msg = _('malformated host namespace "{0}", "{1}" is not a family').format(host_namespace, hostname)
-                    raise DictConsistencyError(msg, 304, hosts.xmlfiles)
-                hosts_name = f"{hostname}.hosts"
-                if hosts_name in self.objectspace.parents[hostname]:
-                    hosts_obj = self.objectspace.paths[hosts_name]
-                    if hosts_obj.type != "domainname":
-                        msg = _('malformated ansible hosts "{0}", is not a "domainname" variable').format(hosts_name)
-                        raise DictConsistencyError(msg, 305, hosts_obj.xmlfiles)
-                    if hosts_obj.multi is False:
-                        msg = _('malformated ansible hosts "{0}", it must be a multiple variable').format(hosts_name)
-                        raise DictConsistencyError(msg, 306, hosts_obj.xmlfiles)
+            super().__init__(
+                *args,
+                force_default_value=True,
+                force_display_unknown_optional_variable=True,
+            )
+
+
+#            host_namespace = self.objectspace.rougailconfig["ansible.inventory.host_namespace"]
+#            namespaces = self.objectspace.parents["."]
+#            if not namespaces:
+#                msg = _("no namespace configured")
+#                raise DictConsistencyError(msg, 300, [])
+#            first_namespace = self.objectspace.paths[namespaces[0]]
+#            if first_namespace.name != first_namespace.namespace:
+#                msg = _("no namespace configured")
+#                raise DictConsistencyError(msg, 301, first_namespace.xmlfiles)
+#            if host_namespace not in namespaces:
+#                msg = _('cannot find host namespace "{0}"').format(host_namespace)
+#                raise DictConsistencyError(msg, 302, first_namespace.xmlfiles)
+#            hostnames = f"{host_namespace}.hostnames"
+#            if hostnames not in self.objectspace.parents[host_namespace]:
+#                hosts = self.objectspace.paths[host_namespace]
+#                msg = _('malformated host namespace "{0}", should have the "hostnames" key').format(host_namespace)
+#                raise DictConsistencyError(msg, 303, hosts.xmlfiles)
+#            for hostname in self.objectspace.parents[hostnames]:
+#                hosts = self.objectspace.paths[hostname]
+#                if hostname not in self.objectspace.families:
+#                    msg = _('malformated host namespace "{0}", "{1}" is not a family').format(host_namespace, hostname)
+#                    raise DictConsistencyError(msg, 304, hosts.xmlfiles)
+#                hosts_name = f"{hostname}.hosts"
+#                if hosts_name in self.objectspace.parents[hostname]:
+#                    hosts_obj = self.objectspace.paths[hosts_name]
+#                    if hosts_obj.type != "domainname":
+#                        msg = _('malformated ansible hosts "{0}", is not a "domainname" variable').format(hosts_name)
+#                        raise DictConsistencyError(msg, 305, hosts_obj.xmlfiles)
+#                    if hosts_obj.multi is False:
+#                        msg = _('malformated ansible hosts "{0}", it must be a multiple variable').format(hosts_name)
+#                        raise DictConsistencyError(msg, 306, hosts_obj.xmlfiles)

src/rougail/output_ansible/ansible.py

@@ -38,7 +38,9 @@ class Inventory(RougailOutputJson):
 
     def exporter(self) -> None:
         self.host_namespace = self.rougailconfig["ansible.host_namespace"]
-        self.no_namespace_in_vars = self.rougailconfig["ansible.inventory.no_namespace_in_vars"]
+        self.no_namespace_in_vars = self.rougailconfig[
+            "ansible.inventory.no_namespace_in_vars"
+        ]
         self.export_warnings = self.rougailconfig["ansible.inventory.export_warnings"]
         self.hosts = {}
         super().exporter()
@@ -47,7 +49,11 @@ class Inventory(RougailOutputJson):
         return True
 
     def parse_variable(self, option, child, namespace):
-        if self.support_namespace and namespace and "ansible_host" in option.information.get("tags", tuple()):
+        if (
+            self.support_namespace
+            and namespace
+            and "ansible_host" in option.information.get("tags", tuple())
+        ):
             hosts = option.value.get()
             if not isinstance(hosts, list):
                 hosts = [hosts]
@@ -56,6 +62,7 @@ class Inventory(RougailOutputJson):
             else:
                 self.hosts[namespace] = hosts
         super().parse_variable(option, child, namespace)
+
     #
     #    def manage_errors(self) -> bool:
     #        if not super().manage_errors():
@@ -135,6 +142,7 @@ class Inventory(RougailOutputJson):
                     ret["_meta"]["hostvars"][host] = {"ansible_host": domain_name}
                     if self.no_namespace_in_vars:
                         from rougail.tiramisu import normalize_family
+
                         host_namespace = normalize_family(host)
                         if host_namespace in self.dico:
                             ret["_meta"]["hostvars"][host].update(
@@ -144,7 +152,9 @@ class Inventory(RougailOutputJson):
                         if host in namespaces:
                             for namespace in namespaces[host]:
                                 if namespace in self.dico:
-                                    ret["_meta"]["hostvars"][host][namespace] = self.dico[namespace]
+                                    ret["_meta"]["hostvars"][host][namespace] = (
+                                        self.dico[namespace]
+                                    )
                         else:
                             ret["_meta"]["hostvars"][host].update(self.dico)
                     if host in extra_vars:

src/rougail/output_ansible/config.py

@@ -18,6 +18,7 @@ along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 from .i18n import _
 from pathlib import Path
+
 try:
     from ..output_doc.config import OutPuts
 except:
@@ -75,9 +76,12 @@ ansible:
     default: inventory
     choices:
       - inventory
-"""]
+""",
+    ]
     if doc_outputs:
-        options[-1] += f"""
+        options[
+            -1
+        ] += f"""
       - doc
 
   host_namespace: hosts  # {_('Namespace with host values')}
@@ -99,7 +103,9 @@ ansible:
 """
     for output in doc_outputs:
         options[-1] += f"        - {output}\n"
-    options[-1] += f"""
+    options[
+        -1
+    ] += f"""
     collection_type:
       description: {_('collection contents')}
       choices:
@@ -135,6 +141,16 @@ ansible:
           - directory
       mandatory: false
 
+    extra_vars:
+      description: {_('Add extra vars inside Playbook or Role')}
+      type: sequence
+
+      key:
+        description: {_('Key name')}
+        mandatory: false
+
+      value:  # {_('Value')}
+
   inventory:
     description: {_("Inventory configuration")}
     disabled:

src/rougail/output_ansible/doc.py

@@ -42,7 +42,8 @@ class Doc(RougailOutputDoc):
     ) -> None:
         self.config = config
         self.ori_rougailconfig = rougailconfig
-        self.doc_rougailconfig = {"doc.tabulars.with_commandline": False,
+        self.doc_rougailconfig = {
+            "doc.tabulars.with_commandline": False,
             "doc.tabulars.with_environment": False,
             "main_namespace": None,
             "step.output": "ansible",
@@ -63,62 +64,90 @@ class Doc(RougailOutputDoc):
         super().__init__(config, rougailconfig=self.doc_rougailconfig, **kwargs)
 
     def run(self) -> str:
-        types = [config.name() for config in self.config if config.name() != self.ori_rougailconfig["ansible.host_namespace"]]
+        types = [
+            config.name()
+            for config in self.config
+            if config.name() != self.ori_rougailconfig["ansible.host_namespace"]
+        ]
         self.root_config = self.config
         self.load()
         self.load_formatter()
         self.root_directory = self.ori_rougailconfig["ansible.doc.root_directory"]
+        self.extra_vars = dict(self.ori_rougailconfig["ansible.doc.extra_vars"].items())
         if self.root_directory is None:
             self.root_directory = Path(".")
         else:
             self.root_directory = Path(self.root_directory)
         config = self._build_example_config()
-        examples = self._gen_doc_examples(config, True)
+        examples = self._gen_doc_examples(config, True, with_secret_manager=False)
         config.property.read_only()
         hidden = CommentedMap()
         config.property.remove("mandatory")
-        self._example_parse_family(config.value.get(), hidden, dump_type="hidden")
+        self._example_parse_family(
+            config.value.get(), hidden, dump_type="hidden", with_true_path=True
+        )
         config.property.read_write()
         self.ansible_name = self.ori_rougailconfig["ansible.doc.project_name"]
         self._build_defaults(config)
-        self._build_vars(examples)
+        # FIXME        self._build_vars(examples)
         # Description
         author = self.ori_rougailconfig["ansible.doc.author"]
-        name = f'{author}.{self.ansible_name}'
+        name = f"{author}.{self.ansible_name}"
         help_ = None
-        description = self.ansible_name
+        description = None
         if self.ansible_name in self.informations:
             if "help" in self.informations[self.ansible_name]["informations"]:
                 help_ = self.informations[self.ansible_name]["informations"].pop("help")
             if "description" in self.informations[self.ansible_name]["informations"]:
-                description = self.informations[self.ansible_name]["informations"]["description"]
+                description = self.informations[self.ansible_name]["informations"][
+                    "description"
+                ]
                 title = f"{name} - {description}"
             else:
                 title = name
         else:
             title = name
         datas = [self.formatter.title(title, 1, collapse=False)]
-        datas.append(_('This repository contains the {0} Ansible collection.').format(self.formatter.prop(name, False, False, False)))
+        datas.append(
+            _("This repository contains the {0} Ansible collection.").format(
+                self.formatter.prop(name, False, False, False)
+            )
+        )
         if help_:
             datas.append("\n".join(help_))
         self.doc_rougailconfig["doc.title_level"] = 2
         for type_ in self.informations:
             current_informations = self.informations[type_]["informations"]
             if "description" in current_informations:
-                current_informations["description"] = _('The group variables "{0}" - {1}').format(current_informations["name"], current_informations["description"])
+                current_informations["description"] = _(
+                    'The group variables "{0}" - {1}'
+                ).format(
+                    current_informations["name"], current_informations["description"]
+                )
             else:
-                current_informations["description"] = _("The group variables {0}").format(current_informations["name"])
-#        informations = {self.ansible_name: {"informations": {"description": "Variables", "path": None},
-#                                       "type": "family",
-#                                       "children": self.informations,
-#                                       }}
+                current_informations["description"] = _(
+                    "The group variables {0}"
+                ).format(current_informations["name"])
         datas.append(self.formatter.title(_("Variables"), 2, collapse=False))
         self.formatter.options()
         datas.extend(self.formatter.dict_to_dict(self.informations, level=3))
         yaml = self._build_collection(description, name)
         for t in types:
+            tags = self.config.option(t).information.get("tags", [])
             for y in yaml:
-                y["vars"][t] = f'{{{{ my_{t} }}}}'
+                if self.extra_vars:
+                    y["vars"].update(self.extra_vars)
+            for y in yaml:
+                if tags:
+                    found = True
+                    for tag in tags:
+                        if y["ansible.builtin.import_playbook"].endswith("." + tag):
+                            break
+                    else:
+                        found = False
+                    if not found:
+                        continue
+                y["vars"][t] = f"{{{{ my_{t} }}}}"
         #
         rougail_version = float(SUPPORTED_VERSION[-1])
         if "version" in types:
@@ -127,53 +156,76 @@ class Doc(RougailOutputDoc):
             key = "version"
 
         if hidden:
-            msg = ("Hidden variables can only be modified within a structure file.")
+            msg = "Hidden variables can only be modified within a structure file."
             datas.append(self.formatter.display_family_informations([msg]))
         end_family = self.formatter.end_family(level=2, collapse=False)
         if end_family:
             datas.append(end_family)
         datas.append(self.formatter.title(_("Usage"), 2, collapse=False))
         datas.append(self.formatter.title(_("Example Playbook with Rougail"), 3))
-#        fam_info = self.formatter.family_informations()
-#        if fam_info:
-#            datas.append(fam_info)
         structural = {key: rougail_version}
         for t in types:
-            structural[f'my_{t}'] = {'type': t}
+            structural[f"my_{t}"] = {"type": t}
         if structural:
+            customize = CommentedMap()
+            old_config = self.config
+            test_config = config.config.copy()
+            test_config.property.read_only()
+            test_config.property.remove("mandatory")
+            test_config = test_config.forcepermissive
+            self.config = test_config
+            self._example_parse_family(
+                test_config.value.get(),
+                customize,
+                dump_type="empty",
+                with_secret_manager=False,
+                with_true_path=True,
+            )
+            self.config = old_config
             datas.append(_("Add to your structural file something like:"))
             datas.append(self.formatter.yaml(dump(structural), yaml_version="1.2"))
             for t in types:
-                if t in hidden:
+                if t in customize and t in hidden:
+                    structural[f"my_{t}"].update(customize[t])
             datas.append(_("Customizing hidden variables in structure file:"))
-                    structural[f'my_{t}'].update(hidden[t])
             datas.append(self.formatter.yaml(dump(structural), yaml_version="1.2"))
-            text = [_('Do not forget to add Rougail structure file as Rougail types.')]
+            text = [_("Do not forget to add Rougail structure file as Rougail types.")]
             datas.append(self.formatter.display_family_informations(text))
         user_data = {}
         for t in types:
             if t in examples:
-                user_data.update({f'my_{t}': examples[t]})
+                user_data.update({f"my_{t}": examples[t]})
         if user_data:
-            datas.append(_("For example you can add an YAML user data with something like:"))
+            datas.append(
+                _("For example you can add an YAML user data with something like:")
+            )
             datas.append(self.formatter.yaml(dump(user_data)))
         datas.append(_("Add to your Play:"))
-        _dump = "\n".join([d[2:] for d in ("  " + dump(yaml)).split('\n')])
+        _dump = "\n".join([d[2:] for d in ("  " + dump(yaml)).split("\n")])
         datas.append(self.formatter.yaml(_dump))
         #
+        examples = self._gen_doc_examples(config, True)
         for t in types:
             if t in examples:
                 for y in yaml:
+                    if t in y["vars"]:
                         y["vars"][t] = deepcopy(examples[t])
+                    if not y["vars"]:
+                        del y["vars"][t]
             else:
                 for y in yaml:
+                    if not y["vars"]:
                         del y["vars"][t]
-        _dump = "\n".join([d[2:] for d in ("  " + dump(yaml)).split('\n')])
+        _dump = "\n".join([d[2:] for d in ("  " + dump(yaml)).split("\n")])
         end_family = self.formatter.end_family(level=3)
         if end_family:
             datas.append(end_family)
         datas.append(self.formatter.title(_("Example Playbook without Rougail"), 3))
-        datas.append(self.formatter.display_family_informations([_('The variables will not be properly validated without Rougail.')]))
+        datas.append(
+            self.formatter.display_family_informations(
+                [_("The variables will not be properly validated without Rougail.")]
+            )
+        )
         datas.append(self.formatter.yaml(_dump))
         end_family = self.formatter.end_family(level=3)
         if end_family:
@@ -197,23 +249,24 @@ class Doc(RougailOutputDoc):
                 for playbook in playbooks_dir.iterdir():
                     if playbook.is_file() and playbook.suffix in [".yml", ".yaml"]:
                         playbook_name = playbook.stem
+                        playbook_import = f"{name}.{playbook_name}"
                         done = True
-                        yaml = {"name": description,
-                                 "hosts": "servers",
-                                 "vars": {},
-                               }
                         if playbook_name in playbooks:
                             playbook_description = playbooks[playbook_name]
                         else:
-                            playbook_description = yaml['name']
-                        playbook_import = f"{name}.{playbook_name}"
-                        yaml["name"] = playbook_description
+                            playbook_description = f"Collection | {playbook_import}"
+                        yaml = {
+                            "name": playbook_description,
+                            "hosts": "servers",
+                            "vars": {},
+                        }
                         yaml["ansible.builtin.import_playbook"] = playbook_import
                         lst.append(yaml)
         if self.collection_type != "playbooks" and not done:
             roles_dir = self.root_directory / "roles"
             if roles_dir.is_dir():
-                yaml = {"name": description,
+                yaml = {
+                    "name": description,
                     "hosts": "servers",
                     "vars": {},
                 }
@@ -225,7 +278,11 @@ class Doc(RougailOutputDoc):
                         yaml["roles"].append({"role": f"{name}.{role_name}"})
                 lst = [yaml]
         if not done:
-            raise Exception(_('Unable to find a Playbook in playbooks/ directory or a role in roles/ directory'))
+            raise Exception(
+                _(
+                    "Unable to find a Playbook in playbooks/ directory or a role in roles/ directory"
+                )
+            )
         return lst
 
     def _build_defaults(self, config):
@@ -246,5 +303,5 @@ class Doc(RougailOutputDoc):
         else:
             filedir = self.root_directory / write_type
         filedir.mkdir(exist_ok=True)
-        with (filedir / "main.yml").open('w') as fh:
+        with (filedir / "main.yml").open("w") as fh:
             fh.write(f"---\n{dump(results)}\n")

tests/results-doc/test_namespace/00_0version_underscore.ansible/vars/main.yml

@@ -1,3 +0,0 @@
----
-rougail:                                # Rougail
-  version: string1                      # A variable

tests/results-doc/test_namespace/00_0version_underscore.sh

@@ -32,6 +32,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -45,7 +54,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -58,7 +67,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_1empty_variable.ansible/vars/main.yml

@@ -1,3 +0,0 @@
----
-rougail:                                # Rougail
-  empty: string1

tests/results-doc/test_namespace/00_1empty_variable.sh

@@ -31,6 +31,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -44,7 +53,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -57,7 +66,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_2default_calculated.sh

@@ -37,6 +37,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -44,7 +53,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -57,8 +66,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_2default_calculated_multi.sh

@@ -40,6 +40,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -47,7 +56,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -60,8 +69,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_2default_calculated_params_permissive.sh

@@ -64,9 +64,6 @@ Customizing hidden variables in structure file:
 version: 1.1                                                                    
 my_rougail:                                                                     
   type: rougail                                                                 
-  leadership:                                                                   
-    - var1: a_value                     # A first variable                      
-      var2: a_value                     # A first variable                      
 ...                                                                             
 
 ▌ 🛈 Informations                                                              
@@ -76,7 +73,7 @@ Customizing hidden variables in structure file:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -89,8 +86,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_2default_calculated_variable.ansible/vars/main.yml

@@ -1,5 +0,0 @@
----
-rougail:                                # Rougail
-  var1:                                 # A first variable
-    - domain1.lan
-    - domain2.lan

tests/results-doc/test_namespace/00_2default_calculated_variable.sh

@@ -45,6 +45,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -60,7 +69,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -73,7 +82,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_2default_calculated_variable_description.ansible/vars/main.yml

@@ -1,3 +0,0 @@
----
-rougail:                                # Rougail
-  var1: string1                         # A first variable

tests/results-doc/test_namespace/00_2default_calculated_variable_description.sh

@@ -36,6 +36,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -49,7 +58,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -62,7 +71,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_2default_calculated_variable_description_multi_line.ansible/vars/main.yml

@@ -1,4 +0,0 @@
----
-rougail:                                # Rougail
-  var1: string1                         # A first variable
-  var3: string1                         # A new variable

tests/results-doc/test_namespace/00_2default_calculated_variable_description_multi_line.sh

@@ -41,6 +41,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -55,7 +64,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -68,7 +77,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_2default_calculated_variable_transitive.ansible/vars/main.yml

@@ -1,5 +0,0 @@
----
-rougail:                                # Rougail
-  var1:                                 # A first variable
-    - domain1.lan
-    - domain2.lan

tests/results-doc/test_namespace/00_2default_calculated_variable_transitive.sh

@@ -46,6 +46,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -61,7 +70,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -74,7 +83,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_4load_subfolder.ansible/vars/main.yml

@@ -1,4 +0,0 @@
----
-rougail:                                # Rougail
-  var1: string1                         # A variable
-  var2: string1                         # A variable

tests/results-doc/test_namespace/00_4load_subfolder.sh

@@ -35,6 +35,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -49,7 +58,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -62,7 +71,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_5load_notype.sh

@@ -33,6 +33,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -40,7 +49,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -53,8 +62,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_6boolean.sh

@@ -48,6 +48,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -55,7 +64,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -68,8 +77,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_6boolean_no_mandatory.sh

@@ -32,6 +32,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -39,7 +48,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -52,8 +61,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_6choice.ansible/vars/main.yml

@@ -1,4 +0,0 @@
----
-rougail:                                # Rougail
-  var1: a                               # The first variable
-  var2: a                               # The second variable

tests/results-doc/test_namespace/00_6choice.sh

@@ -61,6 +61,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -75,7 +84,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -88,7 +97,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_6choice_calculation.sh

@@ -34,6 +34,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -41,7 +50,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -54,8 +63,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_6choice_link.ansible/vars/main.yml

@@ -1,3 +0,0 @@
----
-rougail:                                # Rougail
-  var1: a                               # The first variable

tests/results-doc/test_namespace/00_6choice_link.sh

@@ -42,6 +42,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -55,7 +64,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -68,7 +77,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_6choice_variable.sh

@@ -42,6 +42,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -49,7 +58,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -62,8 +71,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_6choice_variable_link.sh

@@ -50,6 +50,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -57,7 +66,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -70,8 +79,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_6choice_variable_link2.sh

@@ -62,6 +62,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -69,7 +78,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -82,8 +91,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_6custom.ansible/vars/main.yml

@@ -1,3 +0,0 @@
----
-rougail:                                # Rougail
-  custom1: string1                      # The first variable

tests/results-doc/test_namespace/00_6custom.sh

@@ -36,6 +36,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -49,7 +58,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -62,7 +71,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_6domainname.sh

@@ -34,6 +34,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -41,7 +50,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -54,8 +63,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_6domainname_params.sh

@@ -37,6 +37,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -44,7 +53,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -57,8 +66,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_6float.sh

@@ -48,6 +48,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -55,7 +64,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -68,8 +77,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_6integer.sh

@@ -48,6 +48,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -55,7 +64,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -68,8 +77,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_6ip.sh

@@ -48,6 +48,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -55,7 +64,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -68,8 +77,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_6network.sh

@@ -45,6 +45,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -52,7 +61,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -65,8 +74,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_6number.sh

@@ -48,6 +48,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -55,7 +64,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -68,8 +77,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_6port.ansible/vars/main.yml

@@ -1,3 +0,0 @@
----
-rougail:                                # Rougail
-  variable1: '80'                       # A port variable

tests/results-doc/test_namespace/00_6port.sh

@@ -87,6 +87,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -100,7 +109,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -113,7 +122,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_6regexp.sh

@@ -36,6 +36,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -43,7 +52,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -56,8 +65,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_6regexp_link.sh

@@ -43,6 +43,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -50,7 +59,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -63,8 +72,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_6secret.ansible/vars/main.yml

@@ -1,3 +0,0 @@
----
-rougail:                                # Rougail
-  secret1: onE7vaLues_len1              # The first variable

tests/results-doc/test_namespace/00_6secret.sh

@@ -36,6 +36,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -49,7 +58,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -62,7 +71,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_6secret_param.ansible/vars/main.yml

@@ -1,3 +0,0 @@
----
-rougail:                                # Rougail
-  secret1: onE7vaLues_len1              # The first variable

tests/results-doc/test_namespace/00_6secret_param.sh

@@ -57,6 +57,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -70,7 +79,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -83,7 +92,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_6string.ansible/vars/main.yml

@@ -1,5 +0,0 @@
----
-rougail:                                # Rougail
-  var1: string1                         # The first variable
-  var2: string1                         # The second variable
-  var3: string1                         # The third variable

tests/results-doc/test_namespace/00_6string.sh

@@ -54,6 +54,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -69,7 +78,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -82,7 +91,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_7choice_quote.sh

@@ -35,6 +35,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -42,7 +51,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -55,8 +64,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_7help.ansible/vars/main.yml

@@ -1,4 +0,0 @@
----
-rougail:                                # Rougail
-  var1: string1                         # The first variable
-  var2: string1                         # The second variable

tests/results-doc/test_namespace/00_7help.sh

@@ -45,6 +45,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -59,7 +68,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -72,7 +81,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_7help_quote.ansible/vars/main.yml

@@ -1,4 +0,0 @@
----
-rougail:                                # Rougail
-  var1: string1                         # The first variable
-  var2: string1                         # The second variable

tests/results-doc/test_namespace/00_7help_quote.sh

@@ -37,6 +37,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -51,7 +60,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -64,7 +73,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_7help_sup.ansible/vars/main.yml

@@ -1,4 +0,0 @@
----
-rougail:                                # Rougail
-  var1: string1                         # The first <variable>
-  var2: string1                         # The second <variable>

tests/results-doc/test_namespace/00_7help_sup.sh

@@ -45,6 +45,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -59,7 +68,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -72,7 +81,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_7value_doublequote.sh

@@ -33,6 +33,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -40,7 +49,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -53,8 +62,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_7value_doublequote2.sh

@@ -33,6 +33,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -40,7 +49,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -53,8 +62,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_7value_doublequote3.sh

@@ -33,6 +33,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -40,7 +49,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -53,8 +62,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_7value_quote.sh

@@ -33,6 +33,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -40,7 +49,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -53,8 +62,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_8calculation_information.ansible/vars/main.yml

@@ -1,3 +0,0 @@
----
-rougail:                                # Rougail
-  variable: string1                     # A variable

tests/results-doc/test_namespace/00_8calculation_information.sh

@@ -34,6 +34,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -47,7 +56,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -60,7 +69,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_8calculation_namespace.sh

@@ -34,6 +34,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -41,7 +50,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -54,8 +63,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_8calculation_param_namespace.sh

@@ -33,6 +33,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -40,7 +49,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -53,8 +62,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_8test.ansible/vars/main.yml

@@ -1,7 +0,0 @@
----
-rougail:                                # Rougail
-  var1: test                            # The first variable
-  var3: test1                           # The third variable
-  var6:                                 # The sixth variable
-    - test1
-    - test2

tests/results-doc/test_namespace/00_8test.sh

@@ -64,6 +64,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -81,7 +90,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -94,7 +103,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_9choice_variable_multi.ansible/vars/main.yml

@@ -1,5 +0,0 @@
----
-rougail:                                # Rougail
-  variable1:                            # A first variable
-    - val1
-    - val2

tests/results-doc/test_namespace/00_9choice_variable_multi.sh

@@ -40,6 +40,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -55,7 +64,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -68,7 +77,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_9choice_variables.sh

@@ -57,6 +57,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -64,7 +73,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -77,8 +86,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_9default_calculation.sh

@@ -33,6 +33,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -40,7 +49,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -53,8 +62,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_9default_calculation_information.ansible/vars/main.yml

@@ -1,3 +0,0 @@
----
-rougail:                                # Rougail
-  var: string1                          # A variable

tests/results-doc/test_namespace/00_9default_calculation_information.sh

@@ -33,6 +33,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -46,7 +55,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -59,7 +68,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_9default_calculation_information_other_variable.ansible/vars/main.yml

@@ -1,4 +0,0 @@
----
-rougail:                                # Rougail
-  var1: string1                         # A first variable
-  var2: string1                         # A second variable

tests/results-doc/test_namespace/00_9default_calculation_information_other_variable.sh

@@ -36,6 +36,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -50,7 +59,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -63,7 +72,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_9default_calculation_multi_optional.sh

@@ -26,6 +26,12 @@ This family is a namespace
 │               │ (my_variable) │               │              │               │
 │               │ if it is      │               │              │               │
 │               │ defined       │               │              │               │
+│               │ • the value   │               │              │               │
+│               │ of the        │               │              │               │
+│               │ variable      │               │              │               │
+│               │ "my_variable… │               │              │               │
+│               │ if it is      │               │              │               │
+│               │ defined       │               │              │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
   Usage
@@ -41,6 +47,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -48,7 +63,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -61,8 +76,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_9default_calculation_multi_optional2.sh

@@ -22,6 +22,12 @@ This family is a namespace
 │ my_calculate… │ • the value   │  string       │  standard    │  unique       │
 │               │ of the        │ multiple      │              │               │
 │               │ variable      │ mandatory     │              │               │
+│               │ "my_variable… │               │              │               │
+│               │ if it is      │               │              │               │
+│               │ defined       │               │              │               │
+│               │ • the value   │               │              │               │
+│               │ of the        │               │              │               │
+│               │ variable      │               │              │               │
 │               │ "my_variable" │               │              │               │
 │               │ (my_variable) │               │              │               │
 │               │ if it is      │               │              │               │
@@ -41,6 +47,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -48,7 +63,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -61,8 +76,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_9default_calculation_multi_optional_default.sh

@@ -26,6 +26,12 @@ This family is a namespace
 │               │ (my_variable) │               │              │               │
 │               │ if it is      │               │              │               │
 │               │ defined       │               │              │               │
+│               │ • the value   │               │              │               │
+│               │ of the        │               │              │               │
+│               │ variable      │               │              │               │
+│               │ "my_variable… │               │              │               │
+│               │ if it is      │               │              │               │
+│               │ defined       │               │              │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
   Usage
@@ -41,6 +47,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -48,7 +63,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -61,8 +76,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_9default_calculation_optional.ansible/vars/main.yml

@@ -1,6 +0,0 @@
----
-rougail:                                # Rougail
-  my_calculated_variable:
-    - string1
-    - string2
-    - string3

tests/results-doc/test_namespace/00_9default_calculation_optional.sh

@@ -12,13 +12,16 @@ This family is a namespace
 ▌                                                                             
 ▌  standard                                                                   
 
-┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓
-┃ Variable          ┃ Type              ┃ Access control    ┃ Validator        ┃
-┡━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━┩
-│ my_calculated_va… │  string           │  standard         │  unique          │
-│                   │ multiple          │                   │                  │
-│                   │ mandatory         │                   │                  │
-└───────────────────┴───────────────────┴───────────────────┴──────────────────┘
+┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
+┃               ┃               ┃               ┃ Access       ┃               ┃
+┃ Variable      ┃ Default value ┃ Type          ┃ control      ┃ Validator     ┃
+┡━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━┩
+│ my_calculate… │ the value of  │  string       │  standard    │  unique       │
+│               │ the variable  │ multiple      │              │               │
+│               │ "my_variable" │ mandatory     │              │               │
+│               │ if it is      │               │              │               │
+│               │ defined.      │               │              │               │
+└───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
   Usage
 
@@ -33,6 +36,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -49,7 +61,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -62,7 +74,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_9default_calculation_optional_exists.sh

@@ -41,6 +41,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -48,7 +57,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -61,8 +70,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_9default_calculation_param_optional.sh

@@ -36,6 +36,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -43,7 +52,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -56,8 +65,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_9default_information_other_variable.ansible/vars/main.yml

@@ -1,4 +0,0 @@
----
-rougail:                                # Rougail
-  var1: string1                         # A first variable
-  var2: string1                         # A second variable

tests/results-doc/test_namespace/00_9default_information_other_variable.sh

@@ -43,6 +43,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -57,7 +66,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -70,7 +79,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_9default_information_other_variable2.ansible/vars/main.yml

@@ -1,4 +0,0 @@
----
-rougail:                                # Rougail
-  var1: string1                         # A first variable
-  var2: string1                         # A second variable

tests/results-doc/test_namespace/00_9default_information_other_variable2.sh

@@ -43,6 +43,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -57,7 +66,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -70,7 +79,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/00_9default_integer.sh

@@ -34,6 +34,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -41,7 +50,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -54,8 +63,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/00_9default_number.sh

@@ -34,6 +34,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -41,7 +50,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -54,8 +63,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/01_6boolean_multi.sh

@@ -62,6 +62,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -69,7 +78,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -82,8 +91,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install                      
 

tests/results-doc/test_namespace/01_6custom_multi.ansible/vars/main.yml

@@ -1,6 +0,0 @@
----
-rougail:                                # Rougail
-  custom1:                              # A first custom variable
-    - string1
-    - string2
-    - string3

tests/results-doc/test_namespace/01_6custom_multi.sh

@@ -38,6 +38,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -54,7 +63,7 @@ For example you can add an YAML user data with something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -67,7 +76,7 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail:                                                                    

tests/results-doc/test_namespace/01_6float_multi.sh

@@ -62,6 +62,15 @@ Add to your structural file something like:
   type: rougail                                                                 
 ...                                                                             
 
+Customizing hidden variables in structure file:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
 ▌ 🛈 Informations                                                              
 ▌                                                                             
 ▌ Do not forget to add Rougail structure file as Rougail types.               
@@ -69,7 +78,7 @@ Add to your structural file something like:
 Add to your Play:
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
   vars:                                                                         
     rougail: '{{ my_rougail }}'                                                 
@@ -82,8 +91,9 @@ Add to your Play:
 ▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
+- name: Collection | rougail.rougail.install                                    
   hosts: servers                                                                
-  vars: {}                                                                      
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
   ansible.builtin.import_playbook: rougail.rougail.install