diff --git a/docs/structured_data.rst b/docs/structured_data.rst index 6c676c34a..d5ae0abc9 100644 --- a/docs/structured_data.rst +++ b/docs/structured_data.rst @@ -93,6 +93,8 @@ It enables us to: By default there is no namespace. +.. _defaultnamespace: + The default namespace ~~~~~~~~~~~~~~~~~~~~~ diff --git a/docs/tutorial/namespace.rst b/docs/tutorial/namespace.rst index 12f015b81..0e97c77f3 100644 --- a/docs/tutorial/namespace.rst +++ b/docs/tutorial/namespace.rst @@ -24,6 +24,41 @@ Namespaces git clone https://forge.cloud.silique.fr/stove/rougail-tutorials.git git switch --detach 1.1_180 +Namespace +------------ + + + +rougail -m firefox/ -s Firefox --types types/proxy --modes_level basic standard advanced -o doc + +qu'est-ce que c'est que ce -s ? + +rougail -m firefox/ -s Firefox --types types/proxy --modes_level basic standard advanced -u yaml -yf config/01/config.yml + + + +---------------------------------------------------------------------------------- + +Separation of structures into namespaces +---------------------------------------- + +.. glossary:: + + namespace + + A namespace is a way to organize and group related variables under a unique name. + +It enables us to: + +- avoid naming conflicts +- allow logical grouping: related variables can be grouped together +- scope control: namespaces limit the visibility of variable to the namespace itself + +.. note:: By default there is no named namespace set, + actually there is always a namespace, :ref:`the default namespace `. + + +--------------------------------------------------------------------------------- Namespace -----------