-La documentation de ce module est divisée en plusieurs grandes catégories,
-relatives à la documentation théorique (indiquée dans le titre par **[DocT]**),
-à la documentation utilisateur (indiquée dans le titre par **[DocU]**), et à la
-documentation de référence (indiquée dans le titre par **[DocR]**).
-
-La première partie est l':ref:`section_intro`. La seconde partie présente
-:ref:`section_theory`, et à leurs concepts. Pour un utilisateur courant, la
-troisième partie explique comment :ref:`section_using`, et la quatrième partie
-présente des exemples d'utilisation sous la forme de :ref:`section_examples`.
-Les utilisateurs intéressés par un accès rapide au module peuvent s'arrêter
-avant la lecture de la suite, mais un usage utile du module nécessite de lire et
-de revenir régulièrement aux troisième et septième parties. La cinquième partie
-indique les :ref:`section_advanced`, avec l'obtention de renseignements
-supplémentaires ou l'usage par scripts d'exécution sans interface utilisateur
-graphique (GUI). La partie suivante détaille la :ref:`section_reference`, avec
-quatre sous-parties principales qui suivent, la dernière sous-partie décrivant
-une :ref:`section_tui` du module. Enfin, pour respecter les exigences de licence
-du module, n'oubliez pas de lire la partie :ref:`section_license`.
-
-Dans cette documentation, on utilise les notations standards de l'algèbre
-linéaire, de l'assimilation de données (comme décrit dans [Ide97]_) et de
-l'optimisation. En particulier, les vecteurs sont écrits horizontalement ou
-verticalement sans faire la différence. Les matrices sont écrites soit
-normalement, ou avec une notation condensée, consistant à utiliser un espace
-pour séparer les valeurs, et un "``;``" pour séparer les lignes de la matrice,
-de façon continue sur une ligne.
-
-Table des matières
-------------------
+La documentation de ce module est divisée en plusieurs grandes catégories,
+relatives à la documentation théorique (indiquée dans le titre de section par
+**[DocT]**), à la documentation utilisateur (indiquée dans le titre de section
+par **[DocU]**), et à la documentation de référence (indiquée dans le titre de
+section par **[DocR]**).
+
+La première partie est l':ref:`section_intro`. La seconde partie présente
+:ref:`section_theory`, et à leurs concepts, et la partie suivante décrit la
+:ref:`section_methodology`. Pour un utilisateur courant, les parties suivantes
+présentent des exemples didactiques d'utilisation sous la forme de
+:ref:`section_tutorials_in_salome` ou de :ref:`section_tutorials_in_python`,
+puis indique les :ref:`section_advanced`, avec l'obtention de renseignements
+supplémentaires ou l'usage par scripts de commandes hors interface de contrôle
+graphique. Les utilisateurs intéressés par un accès rapide au module peuvent
+s'arrêter avant la lecture de la suite, mais un usage utile du module nécessite
+de lire et de revenir régulièrement à ces parties. Les parties qui suivent
+expliquent comment utiliser une :ref:`section_gui_in_salome` ou une
+:ref:`section_tui`. La dernière grande partie détaille la
+:ref:`section_reference`, avec trois sous-parties essentielles qui la composent
+et qui décrivent les commandes et des options d'algorithmes. Un
+:ref:`section_glossary`, des :ref:`section_notations`, une
+:ref:`section_bibliography` et un :ref:`genindex` développés complètent le
+document. Enfin, pour respecter les exigences de licence du module, n'oubliez
+pas de lire la partie :ref:`section_license`.
+
+**Table des matières**