stove/rougail
3
0
Fork 0
Code Issues 5 Pull requests 1 Projects Releases Wiki Activity

docs(sequence;data-integrity): sequence: remove fixme; data integrity : consitency and coherence

Browse source
This commit is contained in:
gwen 2026-06-13 09:39:07 +02:00
parent 37f146e314
commit c15ed38624
2 changed files with 24 additions and 19 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

21
docs/structured_data/data_integrity.rst
View file

@ -34,16 +34,27 @@ Access control
Overall coherence Overall coherence
----------------- -----------------
An isolated variable can be considered to be of quality but become inconsistent depending on the context.
.. index:: consistency
Consistency Consistency
~~~~~~~~~~~ ~~~~~~~~~~~
For example, if a minimum value and then a maximum value are requested, the minimum must be lesser than the maximum. .. glossary::
Overall consistency is initially managed by personalized validators which will validate the value of a variable in relation to others. consistency
Consistency corresponds to what current market tools offer;
first it is a typed base validation, and then it is a schema-based validation.
For example, if a minimum value and then a maximum value are requested,
the minimum must be lesser than the maximum.
conherence
An isolated variable can be considered to be of quality
but become inconsistent depending on the context.
Overall coherence is initially managed by personalized validators
which will validate the value of a variable in relation to others.
Context access control Context access control
~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~

22
docs/tutorial/sequence.rst
View file

@ -128,25 +128,19 @@ And the Rougail output is:
┃ YAML file "config/02/config.yml" ┃ YAML file "config/02/config.yml"
┗━━ 📓 color (Color): #66cc66 ◀ loaded from the YAML file ┗━━ 📓 color (Color): #66cc66 ◀ loaded from the YAML file
"config/02/config.yml" "config/02/config.yml"
FIXME: je ne comprends pas bien pourquoi on a title qui est une espèce de multi à elle seule dans le output
::
┗━━ 📂 title (Title or Description)
┣━━ 📓 title (Title or Description): My company ◀ loaded from the
┃ YAML file "config/02/config.yml"
┗━━ 📓 color (Color): #66cc66 ◀ loaded from the YAML file
"config/02/config.yml"
.. seealso:: .. seealso::
You can have a look at the Rougail format pages :ref:`Sequence of homogeneous elements <sequence_family>` You can have a look at the Rougail format pages :ref:`Sequence of homogeneous elements <sequence_family>`
.. keypoints:: let's review the key points .. keypoints:: let's review the key points
**Keywords**
Sequence.
We saw a :term:`sequence` type family, which full name is :ref:`Sequence of homogeneous elements <sequence_family>`. We saw a :term:`sequence` type family, which full name is :ref:`Sequence of homogeneous elements <sequence_family>`.
What is remarkable here is that we are dealing with a new form of :ref:`consistency`
which focuses on variables that are similar within a family,
not because they have the same type, but because, as they are lists,
they must have the same number of elements.