feat: gen doc for ansible output

src/rougail/output_ansible/annotator.py

@@ -18,6 +18,8 @@ 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:
@@ -29,4 +31,36 @@ if AnnotatorDoc:
         level = 96
 
         def __init__(self, *args):
-            super().__init__(*args, force_default_value=False)
+            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}", is must be a multi value variable').format(hosts_name)
+                        raise DictConsistencyError(msg, 306, hosts_obj.xmlfiles)

src/rougail/output_ansible/ansible.py

@@ -37,7 +37,7 @@ class Inventory(RougailOutputJson):
         super().__init__(config, rougailconfig=rougailconfig, **kwargs)
 
     def exporter(self) -> None:
-        self.host_namespace = self.rougailconfig["ansible.inventory.host_namespace"]
+        self.host_namespace = self.rougailconfig["ansible.host_namespace"]
         self.no_namespace_in_vars = self.rougailconfig["ansible.inventory.no_namespace_in_vars"]
         self.export_warnings = self.rougailconfig["ansible.inventory.export_warnings"]
         self.hosts = {}
@@ -56,34 +56,13 @@ class Inventory(RougailOutputJson):
             else:
                 self.hosts[namespace] = hosts
         super().parse_variable(option, child, namespace)
-
-    def manage_errors(self) -> bool:
-        if not super().manage_errors():
-            if not self.support_namespace:
-                self.errors.append(_("no namespace configured"))
-            hosts_config = self.config.option(self.host_namespace)
-            try:
-                if hosts_config.group_type() != groups.namespace:
-                    hosts_config = None
-            except AttributeError:
-                hosts_config = None
-            if not hosts_config:
-                if not self.hosts:
-                    self.errors.append(
-                        _('cannot find host namespace "{0}"').format(self.host_namespace)
-                    )
-            else:
-                try:
-                    hosts_config.option("hostnames").name()
-                except AttributeError:
-                    self.errors.append(
-                        _(
-                            'malformated host namespace "{0}", should have the "hostnames" key'
-                        ).format(self.host_namespace)
-                    )
-            # error is added, so replay manage_errors
-            return super().manage_errors()
-        return True
+#
+#    def manage_errors(self) -> bool:
+#        if not super().manage_errors():
+#            hosts_config = self.config.option(self.host_namespace)
+#            # error is added, so replay manage_errors
+#            return super().manage_errors()
+#        return True
 
     def json_to_ansible(self):
         ret = {"_meta": {"hostvars": {}}}
@@ -125,6 +104,8 @@ class Inventory(RougailOutputJson):
                         current_extra_vars = hosts["vars"]["all"]
                     else:
                         current_extra_vars = {}
+                    if not isinstance(hosts["hosts"], list):
+                        pass
                     for idx, host in enumerate(hosts["hosts"]):
                         index = str(idx + 1)
                         if idx < 9:

src/rougail/output_ansible/config.py

@@ -80,13 +80,17 @@ ansible:
         options[-1] += f"""
       - doc
 
+  host_namespace: hosts  # {_('Namespace with host values')}
+
   doc:
     description: {_("Doc configuration")}
     disabled:
       variable: _.output
       when_not: doc
 
-    author: "<author>"  # {_('Ansible author name')}
+    project_name:  # {_('Ansible project name')}
+
+    author:  # {_('Ansible author name')}
 
     output_format:
       description: {_('The output format of the generated documentation')}
@@ -96,14 +100,37 @@ ansible:
     for output in doc_outputs:
         options[-1] += f"        - {output}\n"
     options[-1] += f"""
+    collection_type:
+      description: {_('collection contents')}
+      choices:
+        - auto
+        - playbooks
+        - roles
+      default: auto
+
+    playbooks:
+      _description: {_('Playbooks informations')}
+      type: leadership
+      disabled:
+        jinja: |-
+          {{{{ _.collection_type == "roles" }}}}
+        return_type: boolean
+        description: {_('if the content is a role')}
+
+      name:
+        description: {_('Playbook name')}
+        help: {_('Playbooks are placed in the playbooks/ directory. By default, the description of the "type" is used as the playbook name in the generated example. It is possible to customize this description here.')}
+        mandatory: false
+        multi: true
+
+      description: # {_('Playbook description')}
+
   inventory:
     description: {_("Inventory configuration")}
     disabled:
       variable: _.output
       when_not: inventory
 
-    host_namespace: hosts  # {_('Namespace with host values')}
-
     no_namespace_in_vars: false  # {_('Remove namespace name in host vars')}
 
     export_warnings: true  # {_('Displays warnings inside Ansible exportation datas')}

src/rougail/output_ansible/doc.py

@@ -15,6 +15,13 @@ 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 ruamel.yaml import CommentedMap
+from pathlib import Path
+from copy import deepcopy
+
+from rougail import SUPPORTED_VERSION
+
 from ..output_doc import RougailOutputDoc
 from ..output_doc.utils import dump
 from .i18n import _
@@ -22,6 +29,7 @@ from .i18n import _
 
 class Doc(RougailOutputDoc):
     output_name = "ansible"
+    only_disabled = True
 
     def __init__(
         self,
@@ -41,68 +49,192 @@ class Doc(RougailOutputDoc):
                                   "doc.output_format": rougailconfig["ansible.doc.output_format"],
                                   "doc.true_color": True,
                                   "doc.document_a_type": True,
+                                  "doc.examples.comment": False,
+                                  "doc.examples.comment": True,
+                                  "doc.examples.comment_column": 40,
+                                  "doc.other_root_filenames": {},
                                   "modes_level": rougailconfig["modes_level"],
-                                  "doc.title_level": 1,
+                                  "doc.title_level": 3,
                                   }
         self.comment_examples = True
         self.comment_examples_column = None
         super().__init__(config, rougailconfig=self.doc_rougailconfig, **kwargs)
 
     def run(self) -> str:
-        subconfig = self.config.list()
-        if len(subconfig) != 1 or not subconfig[0].isoptiondescription():
-            raise Exception('not good')  # FIXME
+        types = [config.name() for config in self.config if config.name() != self.ori_rougailconfig["ansible.host_namespace"]]
         self.root_config = self.config
-        self.config = subconfig[0]
         self.load()
         self.load_formatter()
-        self._build_examples()
+        config = self._build_example_config()
+        examples = self._gen_doc_examples(config, True)
+        config.property.read_only()
+        hidden = CommentedMap()
+        config.property.remove("mandatory")
+        self._example_parse_family(config.value.get(), hidden, dump_type="hidden")
+        config.property.read_write()
+        self.ansible_name = self.ori_rougailconfig["ansible.doc.project_name"]
+        self._build_defaults(config)
+        self._build_vars(examples)
         # Description
-        ansible_name = list(self.informations)[0]
-        description = self.informations[ansible_name]["informations"]["description"]
-        self.informations[ansible_name]["informations"]["description"] = _("{0}: {1}").format(_("Ansible role"), description)
-        children = self.informations[ansible_name]["children"]
-        self.informations[ansible_name]["children"] = {}
-        return_string = self.formatter.run(self.informations)
+        author = self.ori_rougailconfig["ansible.doc.author"]
+        name = f'{author}.{self.ansible_name}'
+        help_ = None
+        description = self.ansible_name
+        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"]
+                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)))
+        if help_:
+            datas.append("\n".join(help_))
         self.doc_rougailconfig["doc.title_level"] = 2
-        informations = {ansible_name: {"informations": {"description": "Role variables", "path": None},
-                                       "type": "family",
-                                       "children": children,
-                                       }}
-        return_string += self.formatter.run(informations)
-        yaml = [{"name": description,
-                 "hosts": "server",
-                 "roles": [
-                     {"role": f'{self.ori_rougailconfig["ansible.doc.author"]}.{ansible_name}'}
-                 ],
-                 "vars": f'path.to.{ansible_name}',
-               }]
+        for type_ in self.informations:
+            current_informations = self.informations[type_]["informations"]
+            if "description" in current_informations:
+                current_informations["description"] = _('The group variable "{0}" - {1}').format(current_informations["name"], current_informations["description"])
+            else:
+                current_informations["description"] = _("The group variable {0}").format(current_informations["name"])
+#        informations = {self.ansible_name: {"informations": {"description": "Variables", "path": None},
+#                                       "type": "family",
+#                                       "children": self.informations,
+#                                       }}
+        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:
+            for y in yaml:
+                y["vars"][t] = f'{{{{ my_{t} }}}}'
         #
-        yaml_rougail = {'path': {'to': {f'my_{ansible_name}': {'type': ansible_name}}}}
-        if self.examples_mandatories:
-            yaml_rougail["path"]["to"][f'my_{ansible_name}'].update(self.examples_mandatories[ansible_name])
-        datas = [self.formatter.title(_("Example playbook with Rougail"), 2)]
-        fam_info = self.formatter.family_informations()
-        if fam_info:
-            datas.append(fam_info)
-        text = _('Do not forget to add Rougail structural file as Rougail types.')
-        starts_line = self.formatter.family_informations_starts_line()
-        datas.append(starts_line + text + self.formatter.family_informations_ends_line() + self.formatter.end_family_informations())
-        datas.append(_("Add to your structural file something like:\n\n"))
-        datas.append(self.formatter.yaml(dump(yaml_rougail)))
-        datas.append(_("\nAdd to your playbook:\n\n"))
+        rougail_version = float(SUPPORTED_VERSION[-1])
+        if "version" in types:
+            key = "_version"
+        else:
+            key = "version"
+
+        if hidden:
+            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}
+        if structural:
+            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:
+                    datas.append(_("Customizing hidden variable in structural files:"))
+                    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 structural 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]})
+        if user_data:
+            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')])
         datas.append(self.formatter.yaml(_dump))
-        return_string += self.formatter.compute(datas)
         #
-        if self.examples_mandatories:
-            yaml[0]["vars"] = self.examples_mandatories
-        else:
-            del yaml[0]["vars"]
+        for t in types:
+            if t in examples:
+                for y in yaml:
+                    y["vars"][t] = deepcopy(examples[t])
+            else:
+                for y in yaml:
+                    del y["vars"][t]
         _dump = "\n".join([d[2:] for d in ("  " + dump(yaml)).split('\n')])
-        datas = ["\n" + self.formatter.title(_("Example playbook"), 2),
-                 self.formatter.yaml(_dump),
-                 ]
-        return_string += self.formatter.compute(datas)
+        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.yaml(_dump))
+        end_family = self.formatter.end_family(level=3)
+        if end_family:
+            datas.append(end_family)
+        end_family = self.formatter.end_family(level=2, collapse=False)
+        if end_family:
+            datas.append(end_family)
+        end_family = self.formatter.end_family(level=1, collapse=False)
+        if end_family:
+            datas.append(end_family)
+        return True, self.formatter.compute(datas)
 
-        return True, return_string
+    def _build_collection(self, description, name):
+        self.collection_type = self.ori_rougailconfig["ansible.doc.collection_type"]
+        done = False
+        if self.collection_type != "roles":
+            playbooks = dict(self.ori_rougailconfig["ansible.doc.playbooks"].items())
+            playbooks_dir = Path("playbooks")
+            if playbooks_dir.is_dir():
+                lst = []
+                for playbook in playbooks_dir.iterdir():
+                    if playbook.is_file() and playbook.suffix in [".yml", ".yaml"]:
+                        playbook_name = playbook.stem
+                        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
+                        yaml["ansible.builtin.import_playbook"] = playbook_import
+                        lst.append(yaml)
+        if self.collection_type != "playbooks" and not done:
+            roles_dir = Path("roles")
+            if roles_dir.is_dir():
+                yaml = {"name": description,
+                         "hosts": "servers",
+                         "vars": {},
+                       }
+                yaml["roles"] = []
+                for role in roles_dir.iterdir():
+                    if role.is_dir():
+                        role_name = role.name
+                        done = True
+                        yaml["roles"].append({"role": f"{name}.{role_name}"})
+                lst = [yaml]
+        if not done:
+            raise Exception(_('Unable to find a playbook in playbooks/ or roles in roles/ directories'))
+        return lst
+
+    def _build_defaults(self, config):
+        results = CommentedMap()
+        self._example_parse_family(config.value.get(), results, dump_type="default")
+        self._build_write("defaults", results)
+
+    def _build_vars(self, results):
+        self._build_write("vars", results)
+
+    def _build_write(self, write_type, results):
+        role_dir = Path("roles") / self.ansible_name
+        if role_dir.is_dir():
+            filedir = role_dir / write_type
+        else:
+            filedir = Path(write_type)
+        filedir.mkdir(exist_ok=True)
+        with (filedir / "main.yml").open('w') as fh:
+            fh.write(f"---\n{dump(results)}\n")

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

@@ -1,43 +1,44 @@
-Ansible role: Rougail
+rougail.rougail
 
-▌ 🛈 Informations
-▌ 
-▌  advanced 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+  Variables
 
-  Role variables
-
-
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+Add to your play:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+- name: rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-Add to your playbook:
+    Example playbook without Rougail
 
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+- name: rougail                                                                 
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    

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

@@ -1,43 +1,44 @@
-Ansible role: Rougail
+rougail.rougail
 
-▌ 🛈 Informations
-▌ 
-▌  advanced 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+  Variables
 
-  Role variables
-
-
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+Add to your play:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+- name: rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-Add to your playbook:
+    Example playbook without Rougail
 
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+- name: rougail                                                                 
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    

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

@@ -1,43 +1,44 @@
-Ansible role: Rougail
+rougail.rougail
 
-▌ 🛈 Informations
-▌ 
-▌  advanced 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+  Variables
 
-  Role variables
-
-
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+Add to your play:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+- name: rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-Add to your playbook:
+    Example playbook without Rougail
 
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+- name: rougail                                                                 
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓
 ┃ Variable          ┃ Description       ┃ Type              ┃ Access control   ┃
@@ -14,40 +19,49 @@
 │                   │                   │ mandatory         │                  │
 └───────────────────┴───────────────────┴───────────────────┴──────────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      version: string1                                                          
-
-Add to your playbook:
+my_rougail:                                                                     
+  version: string1                      # A variable                            
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      version: string1  # A variable                                            
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      version: string1                # A variable                              
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━┓
 ┃ Variable                ┃ Type                     ┃ Access control          ┃
@@ -13,40 +18,49 @@
 │ empty                   │  string   mandatory      │  basic                  │
 └─────────────────────────┴──────────────────────────┴─────────────────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      empty: string1                                                            
-
-Add to your playbook:
+my_rougail:                                                                     
+  empty: string1                                                                
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
       empty: string1                                                            
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -15,40 +20,45 @@
 │            │ variable.  │            │ mandatory  │             │            │
 ├────────────┼────────────┼────────────┼────────────┼─────────────┼────────────┤
 │ var2       │ A second   │ the value  │  string    │  standard   │  unique    │
-│            │ variable.  │ of var1    │ multiple   │             │            │
+│            │ variable.  │ of var1.   │ multiple   │             │            │
 │            │            │            │ mandatory  │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -16,40 +21,47 @@
 │            │            │ • maybe    │ mandatory  │             │            │
 ├────────────┼────────────┼────────────┼────────────┼─────────────┼────────────┤
 │ var2       │ A second   │ the value  │  string    │  standard   │  unique    │
-│            │ variable.  │ of "var1"  │ multiple   │             │            │
-│            │            │            │ mandatory  │             │            │
+│            │ variable.  │ of "a      │ multiple   │             │            │
+│            │            │ first      │ mandatory  │             │            │
+│            │            │ variable"  │            │             │            │
+│            │            │ (var1).    │            │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,50 +1,96 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
+
+      leadership
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ This family contains lists of variable blocks.                              
+▌ Path: leadership                                                            
+▌  standard   hidden                                                          
+
+┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
+┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
+┃ Variable   ┃ Descripti… ┃ value      ┃ Type       ┃ control     ┃ Validator  ┃
+┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━┩
+│ leadershi… │ A first    │ • a_value  │  string    │  standard   │  unique    │
+│            │ variable.  │            │ multiple   │             │            │
+│            │            │            │ mandatory  │             │            │
+├────────────┼────────────┼────────────┼────────────┼─────────────┼────────────┤
+│ leadershi… │ A first    │ a_value    │  string    │  standard   │            │
+│            │ variable.  │            │ mandatory  │             │            │
+└────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
 ┃ Variable      ┃ Description   ┃ Default value ┃ Type         ┃ control       ┃
 ┡━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━┩
 │ var2          │ A second      │ depends on a  │  string      │  standard     │
-│               │ variable.     │ calculation   │ mandatory    │               │
+│               │ variable.     │ calculation.  │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Hidden variables can only be modified within a structure file.              
 
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+Customizing hidden variable in structural files:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+  leadership:                                                                   
+    - var1: a_value                     # A first variable                      
+      var2: a_value                     # A first variable                      
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -22,47 +27,58 @@
 │ var2       │ A second   │ the value  │  domainna… │  standard   │  unique    │
 │            │ variable.  │ of the     │ multiple   │             │ Type       │
 │            │            │ variable   │ mandatory  │             │ domainnam… │
-│            │            │ "rougail.… │            │             │            │
+│            │            │ "a first   │            │             │            │
+│            │            │ variable"  │            │             │            │
+│            │            │ (var1).    │            │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var1:                                                                     
-        - domain1.lan                                                           
-        - domain2.lan                                                           
-
-Add to your playbook:
+my_rougail:                                                                     
+  var1:                                 # A first variable                      
+    - domain1.lan                                                               
+    - domain2.lan                                                               
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var1:  # A first variable                                                 
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var1:                           # A first variable                        
         - domain1.lan                                                           
         - domain2.lan                                                           
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -18,40 +23,49 @@
 │               │ variable.     │ variable!     │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var1: string1                                                             
-
-Add to your playbook:
+my_rougail:                                                                     
+  var1: string1                         # A first variable                      
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var1: string1  # A first variable                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var1: string1                   # A first variable                        
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -23,42 +28,51 @@
 │               │ variable.     │               │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var1: string1                                                             
-      var3: string1                                                             
-
-Add to your playbook:
+my_rougail:                                                                     
+  var1: string1                         # A first variable                      
+  var3: string1                         # A new variable                        
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var1: string1  # A first variable                                         
-      var3: string1 # A new variable                                            
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var1: string1                   # A first variable                        
+      var3: string1                   # A new variable                          
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -22,50 +27,59 @@
 │ var2       │ A second   │ the value  │  domainna… │  standard   │  unique    │
 │            │ variable.  │ of the     │ multiple   │             │ • type     │
 │            │            │ variable   │ mandatory  │             │ domainname │
-│            │            │ "rougail.… │            │             │ • the      │
-│            │            │            │            │             │ domain     │
-│            │            │            │            │             │ name can   │
+│            │            │ "a first   │            │             │ • the      │
+│            │            │ variable"  │            │             │ domain     │
+│            │            │ (var1).    │            │             │ name can   │
 │            │            │            │            │             │ be an IP.  │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var1:                                                                     
-        - domain1.lan                                                           
-        - domain2.lan                                                           
-
-Add to your playbook:
+my_rougail:                                                                     
+  var1:                                 # A first variable                      
+    - domain1.lan                                                               
+    - domain2.lan                                                               
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var1:  # A first variable                                                 
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var1:                           # A first variable                        
         - domain1.lan                                                           
         - domain2.lan                                                           
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓
 ┃ Variable          ┃ Description       ┃ Type              ┃ Access control   ┃
@@ -17,42 +22,51 @@
 │                   │                   │ mandatory         │                  │
 └───────────────────┴───────────────────┴───────────────────┴──────────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var1: string1                                                             
-      var2: string1                                                             
-
-Add to your playbook:
+my_rougail:                                                                     
+  var1: string1                         # A variable                            
+  var2: string1                         # A variable                            
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var1: string1  # A variable                                               
-      var2: string1 # A variable                                                
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var1: string1                   # A variable                              
+      var2: string1                   # A variable                              
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -15,36 +20,41 @@
 │               │               │               │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -30,36 +35,41 @@
 │               │ variable.     │               │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃               ┃ Access       ┃
@@ -14,36 +19,41 @@
 │ variable      │ A variable.   │ true          │  boolean      │  standard    │
 └───────────────┴───────────────┴───────────────┴───────────────┴──────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -43,42 +48,51 @@
 │            │            │            │            │             │ • 3        │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var1: a                                                                   
-      var2: a                                                                   
-
-Add to your playbook:
+my_rougail:                                                                     
+  var1: a                               # The first variable                    
+  var2: a                               # The second variable                   
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var1: a  # The first variable                                             
-      var2: a # The second variable                                             
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var1: a                         # The first variable                      
+      var2: a                         # The second variable                     
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -13,39 +18,44 @@
 ┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━┩
 │ var        │ A          │ 9          │  choice    │  standard   │ Choices:   │
 │            │ variable.  │            │ mandatory  │             │ choices is │
-│            │            │            │            │             │ 0 to 9     │
+│            │            │            │            │             │ 0 to 9.    │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -19,43 +24,54 @@
 │ var2       │ The second │ the value  │  choice    │  standard   │ Choices:   │
 │            │ variable.  │ of the     │ mandatory  │             │ • a        │
 │            │            │ variable   │            │             │ • b        │
-│            │            │ "rougail.… │            │             │ • c        │
+│            │            │ "the first │            │             │ • c        │
+│            │            │ variable"  │            │             │            │
+│            │            │ (var1).    │            │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var1: a                                                                   
-
-Add to your playbook:
+my_rougail:                                                                     
+  var1: a                               # The first variable                    
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var1: a  # The first variable                                             
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var1: a                         # The first variable                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -19,39 +24,46 @@
 │            │ variable.  │            │ mandatory  │             │ the value  │
 │            │            │            │            │             │ of the     │
 │            │            │            │            │             │ variable   │
-│            │            │            │            │             │ "rougail.… │
+│            │            │            │            │             │ "a second  │
+│            │            │            │            │             │ variable"  │
+│            │            │            │            │             │ (var1).    │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -19,45 +24,54 @@
 │            │ variable.  │            │ mandatory  │             │ the value  │
 │            │            │            │            │             │ of the     │
 │            │            │            │            │             │ variable   │
-│            │            │            │            │             │ "rougail.… │
+│            │            │            │            │             │ "a second  │
+│            │            │            │            │             │ variable"  │
+│            │            │            │            │             │ (var1).    │
 ├────────────┼────────────┼────────────┼────────────┼─────────────┼────────────┤
 │ var3       │ A third    │ the value  │  choice    │  standard   │ Choices:   │
 │            │ variable.  │ of the     │ mandatory  │             │ the value  │
 │            │            │ variable   │            │             │ of the     │
-│            │            │ "rougail.… │            │             │ variable   │
-│            │            │            │            │             │ "rougail.… │
+│            │            │ "a first   │            │             │ variable   │
+│            │            │ variable"  │            │             │ "a second  │
+│            │            │ (var2).    │            │             │ variable"  │
+│            │            │            │            │             │ (var1).    │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -19,14 +24,17 @@
 │            │ variable.  │            │ mandatory  │             │ the value  │
 │            │            │            │            │             │ of the     │
 │            │            │            │            │             │ variable   │
-│            │            │            │            │             │ "rougail.… │
+│            │            │            │            │             │ "a second  │
+│            │            │            │            │             │ variable"  │
+│            │            │            │            │             │ (var1).    │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
-    family
 
-▌ 🛈 Informations
-▌ 
-▌ Path: family
-▌  standard 
+      family
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Path: family                                                                
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -35,41 +43,47 @@
 │ family.va… │ A third    │ the value  │  choice    │  standard   │ Choices:   │
 │            │ variable.  │ of the     │ mandatory  │             │ the value  │
 │            │            │ variable   │            │             │ of the     │
-│            │            │ "rougail.… │            │             │ variable   │
-│            │            │            │            │             │ "rougail.… │
+│            │            │ "a first   │            │             │ variable   │
+│            │            │ variable"  │            │             │ "a second  │
+│            │            │ (var2).    │            │             │ variable"  │
+│            │            │            │            │             │ (var1).    │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
+  Usage
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
-
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -18,40 +23,49 @@
 │               │ variable.     │               │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      custom1: string1                                                          
-
-Add to your playbook:
+my_rougail:                                                                     
+  custom1: string1                      # The first variable                    
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      custom1: string1  # The first variable                                    
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      custom1: string1                # The first variable                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -16,36 +21,41 @@
 │            │ variable.  │            │            │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -19,36 +24,41 @@
 │            │            │            │            │             │ be an IP.  │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -30,36 +35,41 @@
 │               │ variable.     │               │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -30,36 +35,41 @@
 │               │ variable.     │               │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -30,36 +35,41 @@
 │            │ CIDR type. │            │            │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -27,36 +32,41 @@
 │            │ CIDR type. │            │            │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -30,36 +35,41 @@
 │               │ variable.     │               │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -69,40 +74,49 @@
 │            │            │            │            │             │ allowed.   │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      variable1: '80'                                                           
-
-Add to your playbook:
+my_rougail:                                                                     
+  variable1: '80'                       # A port variable                       
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      variable1: '80'  # A port variable                                        
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      variable1: '80'                 # A port variable                         
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -18,36 +23,41 @@
 │            │ • #b2b2b2  │            │            │             │ "^#(?:[0-… │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -20,40 +25,46 @@
 │ var2       │ A second   │ the value  │  regexp    │  standard   │ Text based │
 │            │ variable.  │ of the     │ mandatory  │             │ with       │
 │            │ Examples:  │ variable   │            │             │ regular    │
-│            │ • #b2b1b1  │ "rougail.… │            │             │ expressio… │
-│            │ • #b3b2b2  │            │            │             │ "^#(?:[0-… │
+│            │ • #b2b1b1  │ "a first   │            │             │ expressio… │
+│            │ • #b3b2b2  │ variable"  │            │             │ "^#(?:[0-… │
+│            │            │ (var1).    │            │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -18,40 +23,49 @@
 │               │ variable.     │               │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      secret1: onE7vaLues_len1                                                  
-
-Add to your playbook:
+my_rougail:                                                                     
+  secret1: onE7vaLues_len1              # The first variable                    
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      secret1: onE7vaLues_len1  # The first variable                            
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      secret1: onE7vaLues_len1        # The first variable                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -13,8 +18,8 @@
 ┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━┩
 │ secret1    │ The first  │            │  secret    │  basic      │ Minimum    │
 │            │ variable.  │            │ mandatory  │             │ length for │
-│            │            │            │            │             │ the secret │
-│            │            │            │            │             │ is 10      │
+│            │ Example:   │            │            │             │ the secret │
+│            │ ALongS4cr… │            │            │             │ is 10      │
 │            │            │            │            │             │ character… │
 ├────────────┼────────────┼────────────┼────────────┼─────────────┼────────────┤
 │ secret2    │ The second │ value      │  secret    │  standard   │ • maximum  │
@@ -39,40 +44,49 @@
 │            │            │            │            │             │ "$".       │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      secret1: onE7vaLues_len1                                                  
-
-Add to your playbook:
+my_rougail:                                                                     
+  secret1: onE7vaLues_len1              # The first variable                    
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      secret1: onE7vaLues_len1  # The first variable                            
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      secret1: onE7vaLues_len1        # The first variable                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -36,44 +41,53 @@
 │               │ variable.     │               │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var1: string1                                                             
-      var2: string1                                                             
-      var3: string1                                                             
-
-Add to your playbook:
+my_rougail:                                                                     
+  var1: string1                         # The first variable                    
+  var2: string1                         # The second variable                   
+  var3: string1                         # The third variable                    
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var1: string1  # The first variable                                       
-      var2: string1 # The second variable                                       
-      var3: string1 # The third variable                                        
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var1: string1                   # The first variable                      
+      var2: string1                   # The second variable                     
+      var3: string1                   # The third variable                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -17,36 +22,41 @@
 │            │            │            │            │             │ • quote"'  │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓
 ┃ Variable          ┃ Description       ┃ Type              ┃ Access control   ┃
@@ -27,42 +32,51 @@
 │                   │ information.      │                   │                  │
 └───────────────────┴───────────────────┴───────────────────┴──────────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var1: string1                                                             
-      var2: string1                                                             
-
-Add to your playbook:
+my_rougail:                                                                     
+  var1: string1                         # The first variable                    
+  var2: string1                         # The second variable                   
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var1: string1  # The first variable                                       
-      var2: string1 # The second variable                                       
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var1: string1                   # The first variable                      
+      var2: string1                   # The second variable                     
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓
 ┃ Variable          ┃ Description       ┃ Type              ┃ Access control   ┃
@@ -19,42 +24,51 @@
 │                   │ Message with ".   │                   │                  │
 └───────────────────┴───────────────────┴───────────────────┴──────────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var1: string1                                                             
-      var2: string1                                                             
-
-Add to your playbook:
+my_rougail:                                                                     
+  var1: string1                         # The first variable                    
+  var2: string1                         # The second variable                   
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var1: string1  # The first variable                                       
-      var2: string1 # The second variable                                       
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var1: string1                   # The first variable                      
+      var2: string1                   # The second variable                     
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓
 ┃ Variable          ┃ Description       ┃ Type              ┃ Access control   ┃
@@ -27,42 +32,51 @@
 │                   │ information.      │                   │                  │
 └───────────────────┴───────────────────┴───────────────────┴──────────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var1: string1                                                             
-      var2: string1                                                             
-
-Add to your playbook:
+my_rougail:                                                                     
+  var1: string1                         # The first <variable>                  
+  var2: string1                         # The second <variable>                 
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var1: string1  # The first <variable>                                     
-      var2: string1 # The second <variable>                                     
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var1: string1                   # The first <variable>                    
+      var2: string1                   # The second <variable>                   
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -15,36 +20,41 @@
 │               │               │               │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -15,36 +20,41 @@
 │               │               │               │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -15,36 +20,41 @@
 │               │               │               │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -15,36 +20,41 @@
 │               │               │               │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -16,36 +21,49 @@
 │               │               │ test_informa… │              │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-
-Add to your playbook:
+my_rougail:                                                                     
+  variable: string1                     # A variable                            
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      variable: string1               # A variable                              
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,50 +1,61 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃               ┃ Access       ┃
 ┃ Variable      ┃ Description   ┃ Default value ┃ Type          ┃ control      ┃
 ┡━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━┩
 │ variable      │ A variable.   │ the value of  │  string       │  standard    │
-│               │               │ the namespace │               │              │
+│               │               │ the           │               │              │
+│               │               │ namespace.    │               │              │
 └───────────────┴───────────────┴───────────────┴───────────────┴──────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,50 +1,60 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃               ┃ Access       ┃
 ┃ Variable      ┃ Description   ┃ Default value ┃ Type          ┃ control      ┃
 ┡━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━┩
 │ variable      │ A variable.   │ depends on a  │  string       │  standard    │
-│               │               │ calculation   │               │              │
+│               │               │ calculation.  │               │              │
 └───────────────┴───────────────┴───────────────┴───────────────┴──────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -46,48 +51,57 @@
 │            │ • test2    │            │            │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var1: test                                                                
-      var3: test1                                                               
-      var6:                                                                     
-        - test1                                                                 
-        - test2                                                                 
-
-Add to your playbook:
+my_rougail:                                                                     
+  var1: test                            # The first variable                    
+  var3: test1                           # The third variable                    
+  var6:                                 # The sixth variable                    
+    - test1                                                                     
+    - test2                                                                     
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var1: test  # The first variable                                          
-      var3: test1 # The third variable                                          
-      var6: # The sixth variable                                                
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var1: test                      # The first variable                      
+      var3: test1                     # The third variable                      
+      var6:                           # The sixth variable                      
         - test1                                                                 
         - test2                                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃ Access       ┃               ┃
@@ -22,44 +27,53 @@
 │               │               │               │              │ • val2        │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      variable1:                                                                
-        - val1                                                                  
-        - val2                                                                  
-
-Add to your playbook:
+my_rougail:                                                                     
+  variable1:                            # A first variable                      
+    - val1                                                                      
+    - val2                                                                      
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      variable1:  # A first variable                                            
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      variable1:                      # A first variable                        
         - val1                                                                  
         - val2                                                                  
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -24,44 +29,56 @@
 │            │            │            │            │             │ value of   │
 │            │            │            │            │             │ the        │
 │            │            │            │            │             │ variable   │
-│            │            │            │            │             │ "rougail.… │
+│            │            │            │            │             │ "the first │
+│            │            │            │            │             │ source     │
+│            │            │            │            │             │ variable"  │
+│            │            │            │            │             │ (source_v… │
 │            │            │            │            │             │ • the      │
 │            │            │            │            │             │ value of   │
 │            │            │            │            │             │ the        │
 │            │            │            │            │             │ variable   │
-│            │            │            │            │             │ "rougail.… │
+│            │            │            │            │             │ "the       │
+│            │            │            │            │             │ second     │
+│            │            │            │            │             │ source     │
+│            │            │            │            │             │ variable"  │
+│            │            │            │            │             │ (source_v… │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,50 +1,60 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
 ┃ Variable      ┃ Description   ┃ Default value ┃ Type         ┃ control       ┃
 ┡━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━┩
 │ variable      │ A variable.   │ concat all    │  string      │  standard     │
-│               │               │ parameters    │ mandatory    │               │
+│               │               │ parameters.   │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,50 +1,68 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
 ┃ Variable      ┃ Description   ┃ Default value ┃ Type         ┃ control       ┃
 ┡━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━┩
 │ var           │ A variable.   │ returns the   │  string      │  standard     │
-│               │               │ information   │ mandatory    │               │
+│               │               │ information.  │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-
-Add to your playbook:
+my_rougail:                                                                     
+  var: string1                          # A variable                            
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var: string1                    # A variable                              
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -15,43 +20,54 @@
 │               │ variable.     │               │ mandatory    │               │
 ├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
 │ var2          │ A second      │ depends on a  │  string      │  standard     │
-│               │ variable.     │ calculation   │ mandatory    │               │
+│               │ variable.     │ calculation.  │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var1: string1                                                             
-
-Add to your playbook:
+my_rougail:                                                                     
+  var1: string1                         # A first variable                      
+  var2: string1                         # A second variable                     
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var1: string1  # A first variable                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var1: string1                   # A first variable                        
+      var2: string1                   # A second variable                       
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃ Access       ┃               ┃
@@ -17,41 +22,47 @@
 │ my_calculate… │ • the value   │  string       │  standard    │  unique       │
 │               │ of the        │ multiple      │              │               │
 │               │ variable      │ mandatory     │              │               │
-│               │ "rougail.my_… │               │              │               │
+│               │ "my_variable" │               │              │               │
+│               │ (my_variable) │               │              │               │
 │               │ if it is      │               │              │               │
 │               │ defined       │               │              │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃ Access       ┃               ┃
@@ -17,41 +22,47 @@
 │ my_calculate… │ • the value   │  string       │  standard    │  unique       │
 │               │ of the        │ multiple      │              │               │
 │               │ variable      │ mandatory     │              │               │
-│               │ "rougail.my_… │               │              │               │
+│               │ "my_variable" │               │              │               │
+│               │ (my_variable) │               │              │               │
 │               │ if it is      │               │              │               │
 │               │ defined       │               │              │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃ Access       ┃               ┃
@@ -17,41 +22,47 @@
 │ my_calculate… │ • the value   │  string       │  standard    │  unique       │
 │               │ of the        │ multiple      │              │               │
 │               │ variable      │ mandatory     │              │               │
-│               │ "rougail.my_… │               │              │               │
+│               │ "my_variable" │               │              │               │
+│               │ (my_variable) │               │              │               │
 │               │ if it is      │               │              │               │
 │               │ defined       │               │              │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓
 ┃ Variable          ┃ Type              ┃ Access control    ┃ Validator        ┃
@@ -15,46 +20,55 @@
 │                   │ mandatory         │                   │                  │
 └───────────────────┴───────────────────┴───────────────────┴──────────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      my_calculated_variable:                                                   
-        - string1                                                               
-        - string2                                                               
-        - string3                                                               
-
-Add to your playbook:
+my_rougail:                                                                     
+  my_calculated_variable:                                                       
+    - string1                                                                   
+    - string2                                                                   
+    - string3                                                                   
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
       my_calculated_variable:                                                   
         - string1                                                               
         - string2                                                               
         - string3                                                               
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃ Access       ┃               ┃
@@ -17,41 +22,47 @@
 ├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
 │ my_calculate… │ the value of  │  string       │  standard    │  unique       │
 │               │ the variable  │ multiple      │              │               │
-│               │ "rougail.my_… │ mandatory     │              │               │
+│               │ "my_variable" │ mandatory     │              │               │
+│               │ (my_variable) │               │              │               │
 │               │ if it is      │               │              │               │
-│               │ defined       │               │              │               │
+│               │ defined.      │               │              │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,53 +1,63 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
 ┃ Variable      ┃ Description   ┃ Default value ┃ Type         ┃ control       ┃
 ┡━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━┩
 │ var1          │ A first       │ returns a     │  string      │  standard     │
-│               │ variable.     │ value         │              │               │
+│               │ variable.     │ value.        │              │               │
 ├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
 │ var2          │ A second      │ no            │  string      │  standard     │
 │               │ variable.     │               │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -19,44 +24,57 @@
 │               │               │ information   │              │               │
 │               │               │ "test_inform… │              │               │
 │               │               │ of the        │              │               │
-│               │               │ variable      │              │               │
-│               │               │ "var1"        │              │               │
+│               │               │ variable "a   │              │               │
+│               │               │ first         │              │               │
+│               │               │ variable"     │              │               │
+│               │               │ (var1).       │              │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var1: string1                                                             
-
-Add to your playbook:
+my_rougail:                                                                     
+  var1: string1                         # A first variable                      
+  var2: string1                         # A second variable                     
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var1: string1  # A first variable                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var1: string1                   # A first variable                        
+      var2: string1                   # A second variable                       
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -19,44 +24,57 @@
 │               │               │ information   │              │               │
 │               │               │ "test_inform… │              │               │
 │               │               │ of the        │              │               │
-│               │               │ variable      │              │               │
-│               │               │ "var1"        │              │               │
+│               │               │ variable "a   │              │               │
+│               │               │ first         │              │               │
+│               │               │ variable"     │              │               │
+│               │               │ (var1).       │              │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var1: string1                                                             
-
-Add to your playbook:
+my_rougail:                                                                     
+  var1: string1                         # A first variable                      
+  var2: string1                         # A second variable                     
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var1: string1  # A first variable                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var1: string1                   # A first variable                        
+      var2: string1                   # A second variable                       
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -13,39 +18,44 @@
 ┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━┩
 │ var        │ A          │ 9          │  choice    │  standard   │ Choices:   │
 │            │ variable.  │            │ mandatory  │             │ choice for │
-│            │            │            │            │             │ 0 to 9     │
+│            │            │            │            │             │ 0 to 9.    │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -13,39 +18,44 @@
 ┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━┩
 │ var        │ A          │ 9          │  choice    │  standard   │ Choices:   │
 │            │ variable.  │            │ mandatory  │             │ choice for │
-│            │            │            │            │             │ 0 to 9     │
+│            │            │            │            │             │ 0 to 9.    │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -44,36 +49,41 @@
 │            │            │            │ mandatory  │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -20,46 +25,55 @@
 │            │ variable.  │            │ mandatory  │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      custom1:                                                                  
-        - string1                                                               
-        - string2                                                               
-        - string3                                                               
-
-Add to your playbook:
+my_rougail:                                                                     
+  custom1:                              # A first custom variable               
+    - string1                                                                   
+    - string2                                                                   
+    - string3                                                                   
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      custom1:  # A first custom variable                                       
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      custom1:                        # A first custom variable                 
         - string1                                                               
         - string2                                                               
         - string3                                                               
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -44,36 +49,41 @@
 │            │            │            │ mandatory  │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -44,36 +49,41 @@
 │            │            │            │ mandatory  │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃ Access       ┃               ┃
@@ -16,46 +21,55 @@
 │               │               │ mandatory     │              │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var:                                                                      
-        - 1                                                                     
-        - 2                                                                     
-        - 3                                                                     
-
-Add to your playbook:
+my_rougail:                                                                     
+  var:                                  # The first variable                    
+    - 1                                                                         
+    - 2                                                                         
+    - 3                                                                         
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var:  # The first variable                                                
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var:                            # The first variable                      
         - 1                                                                     
         - 2                                                                     
         - 3                                                                     
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -16,36 +21,41 @@
 │            │            │            │ mandatory  │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -44,62 +49,71 @@
 │            │            │            │ mandatory  │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var1:                                                                     
-        - string1                                                               
-        - string2                                                               
-        - string3                                                               
-      var2:                                                                     
-        - string1                                                               
-        - string2                                                               
-        - string3                                                               
-      var3:                                                                     
-        - string1                                                               
-        - string2                                                               
-        - string3                                                               
-
-Add to your playbook:
+my_rougail:                                                                     
+  var1:                                 # The first variable                    
+    - string1                                                                   
+    - string2                                                                   
+    - string3                                                                   
+  var2:                                 # The second variable                   
+    - string1                                                                   
+    - string2                                                                   
+    - string3                                                                   
+  var3:                                 # The third variable                    
+    - string1                                                                   
+    - string2                                                                   
+    - string3                                                                   
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var1:  # The first variable                                               
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var1:                           # The first variable                      
         - string1                                                               
         - string2                                                               
         - string3                                                               
-      var2: # The second variable                                               
+      var2:                           # The second variable                     
         - string1                                                               
         - string2                                                               
         - string3                                                               
-      var3: # The third variable                                                
+      var3:                           # The third variable                      
         - string1                                                               
         - string2                                                               
         - string3                                                               
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -25,36 +30,41 @@
 │            │            │            │            │             │ 4 values.  │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -16,36 +21,41 @@
 │            │            │            │ mandatory  │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -16,36 +21,41 @@
 │            │            │            │ mandatory  │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -16,36 +21,41 @@
 │            │            │            │ mandatory  │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -16,36 +21,55 @@
 │            │            │ test_info… │ mandatory  │             │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-
-Add to your playbook:
+my_rougail:                                                                     
+  variable:                             # A variable                            
+    - string1                                                                   
+    - string2                                                                   
+    - string3                                                                   
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      variable:                       # A variable                              
+        - string1                                                               
+        - string2                                                               
+        - string3                                                               
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -19,43 +24,54 @@
 │            │ variable.  │            │ mandatory  │             │ the value  │
 │            │            │            │            │             │ of the     │
 │            │            │            │            │             │ variable   │
-│            │            │            │            │             │ "rougail.… │
+│            │            │            │            │             │ "a first   │
+│            │            │            │            │             │ variable"  │
+│            │            │            │            │             │ (variable… │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      variable2: a                                                              
-
-Add to your playbook:
+my_rougail:                                                                     
+  variable2: a                          # A second variable                     
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      variable2: a  # A second variable                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      variable2: a                    # A second variable                       
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

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

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -17,36 +22,41 @@
 │            │            │            │            │             │ • c        │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

tests/results-doc/test_namespace/02_0tags.sh

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓
 ┃ Variable          ┃ Description       ┃ Type              ┃ Access control   ┃
@@ -21,42 +26,51 @@
 │                   │ • second_tag      │                   │                  │
 └───────────────────┴───────────────────┴───────────────────┴──────────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var1: string1                                                             
-      var2: string1                                                             
-
-Add to your playbook:
+my_rougail:                                                                     
+  var1: string1                         # The first variable                    
+  var2: string1                         # The second variable                   
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var1: string1  # The first variable                                       
-      var2: string1 # The second variable                                       
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var1: string1                   # The first variable                      
+      var2: string1                   # The second variable                     
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

tests/results-doc/test_namespace/04_0type_param.sh

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -20,36 +25,41 @@
 │            │            │            │            │             │ 100.       │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

tests/results-doc/test_namespace/04_0type_param_integer.sh

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -20,36 +25,41 @@
 │            │            │            │            │             │ 100.       │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

tests/results-doc/test_namespace/04_1auto_save.sh

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -16,36 +21,41 @@
 │ modified      │               │               │              │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

tests/results-doc/test_namespace/04_1auto_save_and_calculated.sh

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -16,39 +21,46 @@
 ├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
 │ var2          │ A second      │ the value of  │  string      │  basic        │
 │  auto         │ variable.     │ the variable  │ mandatory    │               │
-│ modified      │               │ "rougail.var… │              │               │
+│ modified      │               │ "a first      │              │               │
+│               │               │ variable"     │              │               │
+│               │               │ (var1).       │              │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

tests/results-doc/test_namespace/04_1auto_save_and_calculated_hidden.sh

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -15,44 +20,49 @@
 │               │ variable.     │               │ mandatory    │               │
 ├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
 │ var2          │ A second      │ the value is  │  string      │  basic        │
-│  auto         │ variable.     │ always yes    │ mandatory    │ hidden        │
+│  auto         │ variable.     │ always yes.   │ mandatory    │ hidden        │
 │ modified      │               │               │              │ Hidden: only  │
 │               │               │               │              │ if the        │
 │               │               │               │              │ variable var1 │
 │               │               │               │              │ has value     │
-│               │               │               │              │ "yes"         │
+│               │               │               │              │ "yes".        │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

tests/results-doc/test_namespace/04_1auto_save_and_hidden.sh

@@ -1,43 +1,75 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
 
+    The group variable "rougail" - Rougail
 
-  Example playbook with Rougail
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
+┃               ┃               ┃               ┃              ┃ Access        ┃
+┃ Variable      ┃ Description   ┃ Default value ┃ Type         ┃ control       ┃
+┡━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━┩
+│ var           │ Autosave      │ yes           │  string      │  basic        │
+│  auto         │ variable.     │               │              │ hidden        │
+│ modified      │               │               │              │               │
+└───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Hidden variables can only be modified within a structure file.              
+
+  Usage
+
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+Customizing hidden variable in structural files:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+  var: yes                                                                      
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

tests/results-doc/test_namespace/04_1default_calculation_hidden.sh

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -18,49 +23,52 @@
 │               │ variable.     │               │ mandatory    │ disabled      │
 │               │               │               │              │ Disabled:     │
 │               │               │               │              │ when the      │
-│               │               │               │              │ variable      │
-│               │               │               │              │ "var1" has    │
+│               │               │               │              │ variable "a   │
+│               │               │               │              │ first         │
+│               │               │               │              │ variable"     │
+│               │               │               │              │ (None) has    │
 │               │               │               │              │ the value     │
-│               │               │               │              │ "value"       │
+│               │               │               │              │ "value".      │
 ├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
 │ var3          │ A third       │ depends on a  │  string      │  standard     │
-│               │ variable.     │ calculation   │ mandatory    │               │
+│               │ variable.     │ calculation.  │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var2: string1                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var2: string1  # A second variable                                        
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

tests/results-doc/test_namespace/04_1default_calculation_hidden_2.sh

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -18,49 +23,60 @@
 │               │ variable.     │               │ mandatory    │ disabled      │
 │               │               │               │              │ Disabled:     │
 │               │               │               │              │ when the      │
-│               │               │               │              │ variable      │
-│               │               │               │              │ "var1" has    │
+│               │               │               │              │ variable "a   │
+│               │               │               │              │ first         │
+│               │               │               │              │ variable"     │
+│               │               │               │              │ (None) has    │
 │               │               │               │              │ the value     │
-│               │               │               │              │ "value"       │
+│               │               │               │              │ "value".      │
 ├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
 │ var3          │ A third       │ depends on a  │  string      │  standard     │
-│               │ variable.     │ calculation   │ mandatory    │               │
+│               │ variable.     │ calculation.  │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var2: string1                                                             
-
-Add to your playbook:
+my_rougail:                                                                     
+  var3: string1                         # A third variable                      
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var2: string1  # A second variable                                        
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var3: string1                   # A third variable                        
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

tests/results-doc/test_namespace/04_1default_calculation_hidden_3.sh

@@ -1,50 +1,88 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
 ┃ Variable      ┃ Description   ┃ Default value ┃ Type         ┃ control       ┃
 ┡━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━┩
+│ var1          │ A first       │ value         │  string      │  standard     │
+│               │ variable.     │               │ mandatory    │ hidden        │
+├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
+│ var2          │ A second      │               │  string      │  basic        │
+│               │ variable.     │               │ mandatory    │ disabled      │
+│               │               │               │              │ Disabled:     │
+│               │               │               │              │ when the      │
+│               │               │               │              │ variable "a   │
+│               │               │               │              │ first         │
+│               │               │               │              │ variable"     │
+│               │               │               │              │ (None) has    │
+│               │               │               │              │ the value     │
+│               │               │               │              │ "value".      │
+├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
 │ var3          │ A third       │ depends on a  │  string      │  standard     │
-│               │ variable.     │ calculation   │ mandatory    │               │
+│               │ variable.     │ calculation.  │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Hidden variables can only be modified within a structure file.              
 
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+Customizing hidden variable in structural files:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+  var1: value                                                                   
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

tests/results-doc/test_namespace/04_1default_calculation_hidden_4.sh

@@ -1,57 +1,96 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
 ┃ Variable      ┃ Description   ┃ Default value ┃ Type         ┃ control       ┃
 ┡━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━┩
-│ var2          │ A second      │               │  string      │  basic        │
-│               │ variable.     │               │ mandatory    │               │
+│ var1          │ A first       │ value         │  string      │  standard     │
+│               │ variable.     │               │ mandatory    │ hidden        │
+├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
+│ var2          │ A second      │               │  string      │  basic        │
+│               │ variable.     │               │ mandatory    │ disabled      │
+│               │               │               │              │ Disabled:     │
+│               │               │               │              │ when the      │
+│               │               │               │              │ variable "a   │
+│               │               │               │              │ first         │
+│               │               │               │              │ variable"     │
+│               │               │               │              │ (None) hasn't │
+│               │               │               │              │ the value     │
+│               │               │               │              │ "value".      │
 ├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
 │ var3          │ A third       │ depends on a  │  string      │  standard     │
-│               │ variable.     │ calculation   │ mandatory    │               │
+│               │ variable.     │ calculation.  │ mandatory    │               │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Hidden variables can only be modified within a structure file.              
 
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+Customizing hidden variable in structural files:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+  var1: value                                                                   
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var2: string1                                                             
-
-Add to your playbook:
+my_rougail:                                                                     
+  var2: string1                         # A second variable                     
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var2: string1  # A second variable                                        
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var2: string1                   # A second variable                       
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

tests/results-doc/test_namespace/04_1default_calculation_hidden_5.sh

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -14,48 +19,73 @@
 │ var1          │ A first       │ value         │  string      │  standard     │
 │               │ variable.     │               │ mandatory    │               │
 ├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
+│ var2          │ A second      │ the value of  │  string      │  standard     │
+│               │ variable.     │ the variable  │ mandatory    │ hidden        │
+│               │               │ "a first      │              │               │
+│               │               │ variable"     │              │               │
+│               │               │ (var1).       │              │               │
+├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
 │ var3          │ A third       │               │  string      │  basic        │
 │               │ variable.     │               │ mandatory    │ disabled      │
 │               │               │               │              │ Disabled:     │
-│               │               │               │              │ depends on an │
-│               │               │               │              │ undocumented  │
-│               │               │               │              │ variable      │
+│               │               │               │              │ when the      │
+│               │               │               │              │ variable "a   │
+│               │               │               │              │ second        │
+│               │               │               │              │ variable"     │
+│               │               │               │              │ (None) has    │
+│               │               │               │              │ the value     │
+│               │               │               │              │ "value".      │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Hidden variables can only be modified within a structure file.              
 
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var3: string1                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+Customizing hidden variable in structural files:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+  var2: value                                                                   
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var3: string1  # A third variable                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

tests/results-doc/test_namespace/04_1default_calculation_hidden_6.sh

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -14,48 +19,81 @@
 │ var1          │ A first       │ value         │  string      │  standard     │
 │               │ variable.     │               │ mandatory    │               │
 ├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
+│ var2          │ A second      │ the value of  │  string      │  standard     │
+│               │ variable.     │ the variable  │ mandatory    │ hidden        │
+│               │               │ "a first      │              │               │
+│               │               │ variable"     │              │               │
+│               │               │ (var1).       │              │               │
+├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
 │ var3          │ A third       │               │  string      │  basic        │
 │               │ variable.     │               │ mandatory    │ disabled      │
 │               │               │               │              │ Disabled:     │
-│               │               │               │              │ depends on an │
-│               │               │               │              │ undocumented  │
-│               │               │               │              │ variable      │
+│               │               │               │              │ when the      │
+│               │               │               │              │ variable "a   │
+│               │               │               │              │ second        │
+│               │               │               │              │ variable"     │
+│               │               │               │              │ (None) hasn't │
+│               │               │               │              │ the value     │
+│               │               │               │              │ "value".      │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Hidden variables can only be modified within a structure file.              
 
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+Customizing hidden variable in structural files:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+  var2: value                                                                   
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      var3: string1                                                             
-
-Add to your playbook:
+my_rougail:                                                                     
+  var3: string1                         # A third variable                      
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      var3: string1  # A third variable                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      var3: string1                   # A third variable                        
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

tests/results-doc/test_namespace/04_1jinja_and_hidden.sh

@@ -0,0 +1,85 @@
+rougail.rougail - Rougail
+
+This repository contains the  rougail.rougail  Ansible Collection.
+
+This family is a namespace
+
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
+
+┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
+┃               ┃               ┃               ┃              ┃ Access        ┃
+┃ Variable      ┃ Description   ┃ Default value ┃ Type         ┃ control       ┃
+┡━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━┩
+│ var1          │ A first       │ A             │  boolean     │  standard     │
+│               │ variable.     │ description.  │ mandatory    │ hidden        │
+├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
+│ var2          │ A second      │               │  string      │  basic        │
+│               │ variable.     │               │ mandatory    │ disabled      │
+│               │               │               │              │ Disabled:     │
+│               │               │               │              │ when the      │
+│               │               │               │              │ variable "A   │
+│               │               │               │              │ first         │
+│               │               │               │              │ variable"     │
+│               │               │               │              │ (None) has    │
+│               │               │               │              │ the value     │
+│               │               │               │              │ "true".       │
+└───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Hidden variables can only be modified within a structure file.              
+
+  Usage
+
+    Example playbook with Rougail
+
+Add to your structural file something like:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+Customizing hidden variable in structural files:
+
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+  var1: true                                                                    
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+Add to your play:
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

tests/results-doc/test_namespace/04_5disabled_calculation.sh

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -18,51 +23,62 @@
 │               │ variable.     │               │ mandatory    │ disabled      │
 │               │               │               │              │ Disabled: if  │
 │               │               │               │              │ condition is  │
-│               │               │               │              │ egal to "yes" │
+│               │               │               │              │ egal to       │
+│               │               │               │              │ "yes".        │
 ├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
 │ variable2     │ A second      │               │  string      │  basic        │
 │               │ variable.     │               │ mandatory    │ disabled      │
 │               │               │               │              │ Disabled: if  │
 │               │               │               │              │ condition is  │
-│               │               │               │              │ egal to "yes" │
+│               │               │               │              │ egal to       │
+│               │               │               │              │ "yes".        │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      variable1: string1                                                        
-      variable2: string1                                                        
-
-Add to your playbook:
+my_rougail:                                                                     
+  variable1: string1                    # A first variable                      
+  variable2: string1                    # A second variable                     
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      variable1: string1  # A first variable                                    
-      variable2: string1 # A second variable                                    
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      variable1: string1              # A first variable                        
+      variable2: string1              # A second variable                       
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

tests/results-doc/test_namespace/04_5disabled_calculation_boolean.sh

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -18,52 +23,60 @@
 │               │ variable.     │               │ mandatory    │ disabled      │
 │               │               │               │              │ Disabled: if  │
 │               │               │               │              │ condition is  │
-│               │               │               │              │ egal to "yes" │
+│               │               │               │              │ egal to       │
+│               │               │               │              │ "yes".        │
 ├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
 │ variable2     │ A seconde     │               │  string      │  basic        │
 │               │ variable.     │               │ mandatory    │ disabled      │
 │               │               │               │              │ Disabled: if  │
 │               │               │               │              │ condition is  │
 │               │               │               │              │ not egal to   │
-│               │               │               │              │ "yes"         │
+│               │               │               │              │ "yes".        │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      variable1: string1                                                        
-      variable2: string1                                                        
-
-Add to your playbook:
+my_rougail:                                                                     
+  variable1: string1                    # A first variable                      
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      variable1: string1  # A first variable                                    
-      variable2: string1 # A seconde variable                                   
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      variable1: string1              # A first variable                        
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

tests/results-doc/test_namespace/04_5disabled_calculation_default.sh

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  standard 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  standard                                                                   
 
 ┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
 ┃               ┃               ┃               ┃              ┃ Access        ┃
@@ -15,48 +20,53 @@
 │               │               │               │ mandatory    │               │
 ├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
 │ var1          │ A first       │ the value of  │  string      │  standard     │
-│               │ variable.     │ condition     │ mandatory    │ disabled      │
+│               │ variable.     │ condition.    │ mandatory    │ disabled      │
 │               │               │               │              │ Disabled: if  │
 │               │               │               │              │ condition is  │
-│               │               │               │              │ yes           │
+│               │               │               │              │ yes.          │
 ├───────────────┼───────────────┼───────────────┼──────────────┼───────────────┤
 │ var2          │ A second      │ the value of  │  string      │  standard     │
-│               │ variable.     │ condition     │ mandatory    │ disabled      │
+│               │ variable.     │ condition.    │ mandatory    │ disabled      │
 │               │               │               │              │ Disabled: if  │
 │               │               │               │              │ condition is  │
-│               │               │               │              │ yes           │
+│               │               │               │              │ yes.          │
 └───────────────┴───────────────┴───────────────┴──────────────┴───────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
-
+%YAML 1.2                                                                       
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
 
-Add to your playbook:
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
 
-  Example playbook
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
+  vars: {}                                                                      
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+

tests/results-doc/test_namespace/04_5disabled_calculation_multi.sh

@@ -1,11 +1,16 @@
-Ansible role: Rougail
+rougail.rougail - Rougail
 
-▌ 🛈 Informations
-▌ 
-▌  basic 
+This repository contains the  rougail.rougail  Ansible Collection.
 
+This family is a namespace
 
-  Role variables
+  Variables
+
+    The group variable "rougail" - Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌  basic                                                                      
 
 ┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
 ┃            ┃            ┃ Default    ┃            ┃ Access      ┃            ┃
@@ -21,7 +26,7 @@
 │            │            │            │            │ if          │            │
 │            │            │            │            │ condition   │            │
 │            │            │            │            │ is egal to  │            │
-│            │            │            │            │ "yes"       │            │
+│            │            │            │            │ "yes".      │            │
 ├────────────┼────────────┼────────────┼────────────┼─────────────┼────────────┤
 │ variable2  │ A second   │            │  string    │  basic      │  unique    │
 │            │ variable.  │            │ multiple   │ disabled    │            │
@@ -29,57 +34,66 @@
 │            │            │            │            │ if          │            │
 │            │            │            │            │ condition   │            │
 │            │            │            │            │ is egal to  │            │
-│            │            │            │            │ "yes"       │            │
+│            │            │            │            │ "yes".      │            │
 └────────────┴────────────┴────────────┴────────────┴─────────────┴────────────┘
 
-  Example playbook with Rougail
-
-▌ 🛈 Informations
-▌ 
-▌ Do not forget to add Rougail structural file as Rougail types.
+  Usage
 
+    Example playbook with Rougail
 
 Add to your structural file something like:
 
+%YAML 1.2                                                                       
+---                                                                             
+version: 1.1                                                                    
+my_rougail:                                                                     
+  type: rougail                                                                 
+...                                                                             
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ Do not forget to add Rougail structural file as Rougail types.              
+
+For example you can add an YAML user data with something like:
 
 ---                                                                             
-path:                                                                           
-  to:                                                                           
-    my_rougail:                                                                 
-      type: rougail                                                             
-      variable1:                                                                
-        - string1                                                               
-        - string2                                                               
-        - string3                                                               
-      variable2:                                                                
-        - string1                                                               
-        - string2                                                               
-        - string3                                                               
-
-Add to your playbook:
+my_rougail:                                                                     
+  variable1:                            # A first variable                      
+    - string1                                                                   
+    - string2                                                                   
+    - string3                                                                   
+  variable2:                            # A second variable                     
+    - string1                                                                   
+    - string2                                                                   
+    - string3                                                                   
 
+Add to your play:
 
 ---                                                                             
 - name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
-  vars: path.to.rougail                                                         
-
-  Example playbook
-
----                                                                             
-- name: Rougail                                                                 
-  hosts: server                                                                 
-  roles:                                                                        
-    - role: <author>.rougail                                                    
+  hosts: servers                                                                
   vars:                                                                         
-    rougail:  # Rougail                                                         
-      variable1:  # A first variable                                            
+    rougail: '{{ my_rougail }}'                                                 
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+
+    Example playbook without Rougail
+
+▌ 🛈 Informations                                                              
+▌                                                                             
+▌ The variables will not be properly validated without Rougail.               
+
+---                                                                             
+- name: Rougail                                                                 
+  hosts: servers                                                                
+  vars:                                                                         
+    rougail:                                                                    
+      variable1:                      # A first variable                        
         - string1                                                               
         - string2                                                               
         - string3                                                               
-      variable2: # A second variable                                            
+      variable2:                      # A second variable                       
         - string1                                                               
         - string2                                                               
         - string3                                                               
+  ansible.builtin.import_playbook: rougail.rougail.install                      
+