X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Findex.rst;h=8ace4de17d8ba1b0507e2f14e3623d8281c42ea6;hb=3de2be82504022143af3bd999a19d03607b8d08b;hp=d2d922c5e2ad62c3804802a72dbe058079d0d21d;hpb=d602c41220cd6708b0afd3882b2bf98b18ff7a5a;p=modules%2Fadao.git

diff --git a/doc/index.rst b/doc/index.rst
index d2d922c..8ace4de 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -1,34 +1,44 @@
-
 ================================================================================
 ADAO module documentation
 ================================================================================
 
-The ADAO module provides **data assimilation** features in SALOME context. It is
-based on usage of other SALOME modules, namely YACS and EFICAS, and on an
-extensible generic underlying data assimilation library.
+.. image:: images/ADAO_logo.png
+   :align: center
+   :width: 20%
+
+The ADAO module provides **data assimilation and optimization** features in
+SALOME context. It is based on usage of other SALOME modules, namely YACS and
+EFICAS, and on usage of a generic underlying data assimilation library.
 
 Briefly stated, Data Assimilation is a methodological framework to compute the
 optimal estimate of the inaccessible true value of a system state over time. It
 uses information coming from experimental measurements or observations, and from
 numerical *a priori* models, including information about their errors. Parts of
-the framework are also known as *parameter estimation*, *inverse problems*,
-*bayesian estimation*, *optimal interpolation*, etc. More details can be found
-in the section :ref:`section_theory`.
-
-The documentation of this module is divided in 5 parts, the first one being an
-introduction. The second part briefly introduces data assimilation and concepts.
-The third part describes how to use the module ADAO. The fourth part gives
-examples on ADAO usage. Users interested in quick use of the module can jump to
-this section :ref:`section_examples`, but a valuable use of the module requires
-to read and come back regularly to the section :ref:`section_using`. The last
-part focuses on advanced usages of the module, how to get more information, or
-how to use it without the graphical user interface (GUI). 
-
-In all this documentation, we use standard notations of data assimilation, as
-described in [Ide97]. Moreover, vectors are written horizontally or vertically
-without making difference. Matrices are written either normally, or with a
-condensed notation, consisting in the use of a space to separate values and a
-"``;``" to separate the rows, in a continuous line.
+the framework are also known under the names of *parameter estimation*, *inverse
+problems*, *Bayesian estimation*, *optimal interpolation*, etc. More details can
+be found in the section :ref:`section_theory`.
+
+The documentation of this module is divided in parts. The first one
+:ref:`section_intro` is an introduction. The second part :ref:`section_theory`
+briefly introduces data assimilation, optimization and concepts. The third part
+:ref:`section_using` describes how to use the module ADAO. The fourth part
+:ref:`section_reference` gives a detailed description of all the ADAO commands
+and keywords. The fifth part :ref:`section_examples` gives examples on ADAO
+usage. Users interested in quick use of the module can jump to this section, but
+a valuable use of the module requires to read and come back regularly to the
+third and fourth ones. The last part :ref:`section_advanced` focuses on advanced
+usages of the module, how to get more information, or how to use it by
+scripting, without the graphical user interface (GUI). 
+
+In all this documentation, we use standard notations of linear algebra, data
+assimilation (as described in [Ide97]_) and optimization. In particular, vectors
+are written horizontally or vertically without making difference. Matrices are
+written either normally, or with a condensed notation, consisting in the use of
+a space to separate values and a "``;``" to separate the rows, in a continuous
+line.
+
+Table of contents
+-----------------
 
 .. toctree::
    :maxdepth: 2
@@ -36,12 +46,15 @@ condensed notation, consisting in the use of a space to separate values and a
    intro
    theory
    using
+   reference
    examples
    advanced
+   licence
    bibliography
 
 Indices and tables
-================================================================================
+------------------
 
 * :ref:`genindex`
 * :ref:`search`
+* :ref:`section_glossary`