AntaresSimulatorTeam
diff --git a/‎.gitignore‎
Lines changed: 2 additions & 1 deletion b/‎.gitignore‎
Lines changed: 2 additions & 1 deletion
diff --git a/‎LOCAL_SITE_README.md‎
Lines changed: 1 addition & 0 deletions b/‎LOCAL_SITE_README.md‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎README.md‎
Lines changed: 4 additions & 3 deletions b/‎README.md‎
Lines changed: 4 additions & 3 deletions
diff --git a/‎doc/0_Home/2_core_concepts.md‎
Lines changed: 4 additions & 27 deletions b/‎doc/0_Home/2_core_concepts.md‎
Lines changed: 4 additions & 27 deletions
diff --git a/‎doc/0_Home/3_use_cases.md‎
Lines changed: 4 additions & 29 deletions b/‎doc/0_Home/3_use_cases.md‎
Lines changed: 4 additions & 29 deletions
diff --git a/‎doc/0_Home/4_release_notes.md‎
Lines changed: 12 additions & 28 deletions b/‎doc/0_Home/4_release_notes.md‎
Lines changed: 12 additions & 28 deletions
diff --git a/‎doc/0_Home/5_support.md‎
Lines changed: 4 additions & 29 deletions b/‎doc/0_Home/5_support.md‎
Lines changed: 4 additions & 29 deletions
diff --git a/‎doc/1_Overview/1_Architecture.md‎
Lines changed: 4 additions & 27 deletions b/‎doc/1_Overview/1_Architecture.md‎
Lines changed: 4 additions & 27 deletions
diff --git a/‎doc/1_Overview/2_glossary.md‎
Lines changed: 53 additions & 0 deletions b/‎doc/1_Overview/2_glossary.md‎
Lines changed: 53 additions & 0 deletions
diff --git a/‎doc/1_Overview/2_File_structure.md‎ ‎doc/1_Overview/3_File_structure.md‎doc/1_Overview/2_File_structure.md renamed to doc/1_Overview/3_File_structure.md
Lines changed: 4 additions & 29 deletions b/‎doc/1_Overview/2_File_structure.md‎ ‎doc/1_Overview/3_File_structure.md‎doc/1_Overview/2_File_structure.md renamed to doc/1_Overview/3_File_structure.md
Lines changed: 4 additions & 29 deletions
@@ -210,4 +210,5 @@ marimo/_lsp/
 __marimo__/
 
 # GEMS specific ignores
-output/
+output/
+*env/
@@ -17,6 +17,7 @@ source documentation_env/bin/activate
 
 ```bash
 pip install mkdocs mkdocs-material
+pip install mkdocs-git-revision-date-localized-plugin
 ```
 
 ## 3. Run the site locally
 
@@ -5,7 +5,10 @@
 # What is GEMS?
 
 **GEMS** is a high-level modelling language, close to mathematical syntax, and a data structure for describing energy systems. Compared to other algebraic modelling languages, **GEMS** is object- and graph-oriented, making it particularly well-suited to representing energy systems.
-<br>
+
+<div align="center">
+    <a href="https://gems-energy.readthedocs.io/en/latest/">🌐 Visit Website</a>
+</div>
 
 # Vision and Ambitions for GEMS
 
@@ -43,5 +46,3 @@ The following **interpreters** can be used to run Gems modelling language :
 
 - [Antares Legacy Models to GEMS Converter](https://github.com/AntaresSimulatorTeam/AntaresLegacyModels-to-GEMS-Converter) : a Python package that enables the migration of Antares Legacy Models to GEMS.
 - [PyPSA to Gems Converter](https://github.com/AntaresSimulatorTeam/PyPSA-to-GEMS-Converter), a stand-alone Python package to export PyPSA [Networks](https://docs.pypsa.org/v1.0.2/user-guide/design/#network-object) as [GEMS system](./3_User_Guide/3_GEMS_File_Structure/3_system.md). This converter supports [PyPSA two-stage stochastic optimization problems](https://docs.pypsa.org/v1.0.2/user-guide/optimization/stochastic/): such problems can be addressed by GEMS [interpreters](./1_Overview/1_Architecture.md) and solved with [Antares Xpansion's Benders decomposition algorithm](https://antares-xpansion.readthedocs.io/en/stable/).
-
-<h2 align="center">🌐 <a href="https://gems-energy.readthedocs.io/en/latest/">Visit Website</a></h2>
 
@@ -1,10 +1,7 @@
-<div style="display: flex; justify-content: space-between; align-items: center;">
-    <div style="text-align: left;">
-        <a href="../../../..">Main Section</a>
-    </div>
-    <div style="text-align: right;">
-        <img src="../../assets/gemsV2.png" alt="GEMS Logo" width="150"/>
-    </div>
+<div style="display: flex; justify-content: flex-end;">
+  <a href="../../../..">
+    <img src="../../assets/gemsV2.png" alt="GEMS Logo" width="150"/>
+  </a>
 </div>
 
 # An Optimisation Language Tailored for Energy System Modelling
@@ -102,23 +99,3 @@ This language **differs from traditional optimization languages** in several way
   while clearly separating model structure, data, and assumptions from the underlying optimisation engine.
    </p>
 </div>
-
-**Navigation**
-
-<div style="display: flex; justify-content: space-between;">
-    <div style="text-align: left;">
-    <button type="button" style="background-color:#CCCCCC; border:none; padding:8px 16px; border-radius:4px; cursor:pointer">
-        <a href="../../../.." style="text-decoration:none; color: #000000">⬅️ Previous page</a>
-    </button>
-    </div>
-    <button type="button" style="background-color:#AAAAFF; border:none; padding:8px 16px; border-radius:4px; cursor:pointer">
-        <a href="../../../.." style="text-decoration:none; color: #FFFFFF">Home</a>
-    </button>
-    <div style="text-align: right;">
-    <button type="button" style="background-color:#CCCCCC; border:none; padding:8px 16px; border-radius:4px; cursor:pointer">
-        <a href="../3_use_cases" style="text-decoration:none; color: #000000">Next page ➡️</a>
-    </button>
-    </div>
-</div>
-
----
@@ -1,10 +1,7 @@
-<div style="display: flex; justify-content: space-between; align-items: center;">
-  <div style="text-align: left;">
-    <a href="../../../../..">Main Section</a>
-  </div>
-  <div style="text-align: right;">
+<div style="display: flex; justify-content: flex-end;">
+  <a href="../../../..">
     <img src="../../assets/gemsV2.png" alt="GEMS Logo" width="150"/>
-  </div>
+  </a>
 </div>
 
 # Use Cases
@@ -17,26 +14,4 @@ GEMS modelling language was primarily designed for the following purposes:
 - **Multi-Energy modelling:** GEMS allows the modelling of multi-energy systems. While [Antares Simulator](https://antares-simulator.readthedocs.io/en/latest/) primarily focuses on the electric grid, GEMS extends the modelling scope to integrated multi-energy systems.
 - **[Antares Simulator](https://antares-simulator.readthedocs.io/en/latest/) Legacy Integration (Hybrid Mode):** GEMS can be used in conjunction with [Antares Simulator](https://antares-simulator.readthedocs.io/en/latest/) legacy studies through a hybrid simulation mode, where a study combines two modelling components: one based on the legacy framework and one based on GEMS.
 
-As a general-purpose algebraic modelling language, other use cases can also be envisioned for GEMS.
-
----
-
-**Navigation**
-
-<div style="display: flex; justify-content: space-between;">
-  <div style="text-align: left;">
-  <button type="button" style="background-color:#CCCCCC; border:none; padding:8px 16px; border-radius:4px; cursor:pointer">
-  <a href="../2_core_concepts" style="text-decoration:none; color: #000000">⬅️ Previous page</a>
-  </button>
-  </div>
-  <button type="button" style="background-color:#AAAAFF; border:none; padding:8px 16px; border-radius:4px; cursor:pointer">
-  <a href="../../../.." style="text-decoration:none; color: #FFFFFF">Home</a>
-  </button>
-  <div style="text-align: right;">
-  <button type="button" style="background-color:#CCCCCC; border:none; padding:8px 16px; border-radius:4px; cursor:pointer">
-  <a href="../4_release_notes" style="text-decoration:none; color: #000000">Next page ➡️</a>
-  </button>
-  </div>
-</div>
-
----
+As a general-purpose algebraic modelling language, other use cases can also be envisioned for GEMS.
@@ -1,39 +1,23 @@
-<div style="display: flex; justify-content: space-between; align-items: center;">
-    <div style="text-align: left;">
-        <a href="../../../..">Main Section</a>
-    </div>
-    <div style="text-align: right;">
+<div style="display: flex; justify-content: flex-end;">
+    <a href="../../../..">
         <img src="../../assets/gemsV2.png" alt="GEMS Logo" width="150"/>
-    </div>
+    </a>
 </div>
 
 # Release Notes
 
-## Version 0.1.0
-
-**Release Date:** *22/01/2026*
+## Version 0.2.0
 
-* Initialization of the documentation
+**Release Date:** *26/03/2026*
 
+* Update the appearance of the documentation ([PR32](https://github.com/AntaresSimulatorTeam/GEMS/pull/66))
+* Clarify the distinction between Antares Modeler and Antares Solver ([PR32](https://github.com/AntaresSimulatorTeam/GEMS/pull/66))
+* Dynamic visualization of libraries ([PR31](https://github.com/AntaresSimulatorTeam/GEMS/pull/63))
+* Document floor, ceil, max, min operators ([PR30](https://github.com/AntaresSimulatorTeam/GEMS/pull/62))
 
----
 
-**Navigation**
+## Version 0.1.0
 
-<div style="display: flex; justify-content: space-between;">
-    <div style="text-align: left;">
-    <button type="button" style="background-color:#CCCCCC; border:none; padding:8px 16px; border-radius:4px; cursor:pointer">
-    <a href="../3_use_cases" style="text-decoration:none; color: #000000">⬅️ Previous page</a>
-    </button>
-    </div>
-    <button type="button" style="background-color:#AAAAFF; border:none; padding:8px 16px; border-radius:4px; cursor:pointer">
-    <a href="../../../.." style="text-decoration:none; color: #FFFFFF">Home</a>
-    </button>
-    <div style="text-align: right;">
-    <button type="button" style="background-color:#CCCCCC; border:none; padding:8px 16px; border-radius:4px; cursor:pointer">
-    <a href="../5_support" style="text-decoration:none; color: #000000">Next page ➡️</a>
-    </button>
-    </div>
-</div>
+**Release Date:** *22/01/2026*
 
----
+* Initialization of the documentation
@@ -1,10 +1,7 @@
-<div style="display: flex; justify-content: space-between; align-items: center;">
-  <div style="text-align: left;">
-    <a href="../../../..">Main Section</a>
-  </div>
-  <div style="text-align: right;">
+<div style="display: flex; justify-content: flex-end;">
+  <a href="../../../..">
     <img src="../../assets/gemsV2.png" alt="GEMS Logo" width="150"/>
-  </div>
+  </a>
 </div>
 
 # Support Contact
@@ -14,26 +11,4 @@
 | GEMS Support                             | [Contact support](../6_Support_Contributing/2_contact.md)   |
 | GEMS Contribution                        | [Contributing Contact](../6_Support_Contributing/3_contributing.md) |
 | GEMS FAQ                                 | [FAQ](../6_Support_Contributing/1_faq.md)                   |
-| Antares Simulator Contact (GitHub Issue) | [Contact Form Website](https://github.com/AntaresSimulatorTeam/Antares_Simulator/issues/new?template=support_request.md) |
-
----
-
-**Navigation**
-
-<div style="display: flex; justify-content: space-between;">
-  <div style="text-align: left;">
-  <button type="button" style="background-color:#CCCCCC; border:none; padding:8px 16px; border-radius:4px; cursor:pointer">
-    <a href="../4_release_notes" style="text-decoration:none; color: #000000">⬅️ Previous page</a>
-  </button>
-  </div>
-  <button type="button" style="background-color:#AAAAFF; border:none; padding:8px 16px; border-radius:4px; cursor:pointer">
-    <a href="../../../.." style="text-decoration:none; color: #FFFFFF">Home</a>
-  </button>
-  <div style="text-align: right;">
-  <button type="button" style="background-color:#CCCCCC; border:none; padding:8px 16px; border-radius:4px; cursor:pointer">
-    <a href="../../1_Overview/1_Architecture" style="text-decoration:none; color: #000000">Next page ➡️</a>
-  </button>
-  </div>
-</div>
-
----
+| Antares Simulator Contact (GitHub Issue) | [Contact Form Website](https://github.com/AntaresSimulatorTeam/Antares_Simulator/issues/new?template=support_request.md) |
@@ -1,10 +1,7 @@
-<div style="display: flex; justify-content: space-between; align-items: center;">
-  <div style="text-align: left;">
-    <a href="../../../..">Main Section</a>
-  </div>
-  <div style="text-align: right;">
+<div style="display: flex; justify-content: flex-end;">
+  <a href="../../../..">
     <img src="../../assets/gemsV2.png" alt="GEMS Logo" width="150"/>
-  </div>
+  </a>
 </div>
 
 # GEMS Architecture Breakthrough
@@ -22,24 +19,4 @@ This architecture of GEMS aims to export the definition of component models and
 
 <div style="text-align: center; width:1000px;">
   <img src="../../assets/Architecture_GEMS.png" alt="Architecture Breakthrough of GEMS comparing to Classical OOME" />
-</div>
-
-**Navigation**
-
-<div style="display: flex; justify-content: space-between;">
-  <div style="text-align: left;">
-  <button type="button" style="background-color:#CCCCCC; border:none; padding:8px 16px; border-radius:4px; cursor:pointer">
-    <a href="../../0_Home/4_release_notes" style="text-decoration:none; color: #000000">⬅️ Previous page</a>
-  </button>
-  </div>
-  <button type="button" style="background-color:#AAAAFF; border:none; padding:8px 16px; border-radius:4px; cursor:pointer">
-    <a href="../../../.." style="text-decoration:none; color: #FFFFFF">Home</a>
-  </button>
-  <div style="text-align: right;">
-  <button type="button" style="background-color:#CCCCCC; border:none; padding:8px 16px; border-radius:4px; cursor:pointer">
-    <a href="../2_File_structure" style="text-decoration:none; color: #000000">Next page ➡️</a>
-  </button>
-  </div>
-</div>
-
----
+</div>
@@ -0,0 +1,53 @@
+<div style="display: flex; justify-content: flex-end;">
+  <a href="../../../..">
+    <img src="../../assets/gemsV2.png" alt="GEMS Logo" width="150"/>
+  </a>
+</div>
+
+# Glossary
+
+This section is a glossary of the main concepts used by GEMS.
+
+## Input Files
+
+| Term    | Definition    |
+|---------|---------------|
+| [Library](../3_User_Guide/3_GEMS_File_Structure/2_library.md) | A file listing all the models representing general unspecified elements of a study. These models are used as "template" for creating their instances, called components|
+| [System](../3_User_Guide/3_GEMS_File_Structure/3_system.md)  | A file listing all the "components", the instances of models defined by the system yaml file, representing all the specified elements of the simulated grid. This file also contains all the connections between the components|
+| [Dataseries](../3_User_Guide/3_GEMS_File_Structure/4_data_series.md) | A table containing all the data through time. It is used by time/scenario dependent components|
+
+## Concepts
+
+### Models and Components
+
+| Concept     | Definition    |
+|-------------|---------------|
+|[Model](../3_User_Guide/3_GEMS_File_Structure/2_library.md#models)| An abstract mathematical configuration representing the general features of a category of grid element. Users can specify any instance of this model for creating each simulated grid's element  |
+|[Component](../3_User_Guide/3_GEMS_File_Structure/3_system.md#components)| An instance using a model as a template. Each component is a specific detailed instance of a model representing a real object. Multiple components can use the same model within a system, each with different parameter values |
+
+### Abstract modelling: Optimization
+
+| Concept              | Definition        |
+|----------------------|-------------------|
+| [Variable](../3_User_Guide/3_GEMS_File_Structure/2_library.md#variables)             | An abstract mathematical variable of a model, whose value is optimized by the solver. The optimization problem is to find the best set of variables based on the variable's configuration, shared across all model instances. |
+| [Parameter](../3_User_Guide/3_GEMS_File_Structure/2_library.md#parameters)            | An input data declared in the model, with a value specific to each component (set in the system.yml file). The optimization problem seeks the best set of variables according to these parameters.               |
+| [Objective function](../3_User_Guide/3_GEMS_File_Structure/2_library.md#objective-contribution)   | The mathematical expression optimized by the solver. Variables are selected to achieve its global minimum based on the input parameters. |
+| [Constraint](../3_User_Guide/3_GEMS_File_Structure/2_library.md#constraints)| A mathematical relationship or condition that restricts the values of variables |
+| [Binding Constraint](../3_User_Guide/3_GEMS_File_Structure/2_library.md#binding-constraints) | A constraint that links variables or ports across different models or components |
+
+### Interfaces and Relationships
+
+| Concept            | Definition        |
+|--------------------|-------------------|
+| [Port](../3_User_Guide/3_GEMS_File_Structure/2_library.md#ports)| A communication interface for exchanging expressions, called "fields"     |
+| [Field](../3_User_Guide/3_GEMS_File_Structure/2_library.md#ports) | An expression exchanged by a port    |
+| [Connection](../3_User_Guide/3_GEMS_File_Structure/3_system.md#connections)| A link between two components' ports |
+
+### Time and Scenario Dependency
+
+| Concept            | Definition            |
+|--------------------|-----------------------|
+| [Time dependent](../3_User_Guide/2_mathematical_syntax.md#time-operators-and-indexing)     |  A parameter or variable depending on time. In this case, the parameter is instantiated as a dataseries. |
+| [Scenario dependent](../3_User_Guide/2_mathematical_syntax.md#scenario-operator) | A parameter or variable depending on the scenario. In this case, the parameter is instantiated as a dataseries. |
+
+
@@ -1,10 +1,7 @@
-<div style="display: flex; justify-content: space-between; align-items: center;">
-  <div style="text-align: left;">
-    <a href="../../../..">Main Section</a>
-  </div>
-  <div style="text-align: right;">
+<div style="display: flex; justify-content: flex-end;">
+  <a href="../../../..">
     <img src="../../assets/gemsV2.png" alt="GEMS Logo" width="150"/>
-  </div>
+  </a>
 </div>
 
 # File Overview : Model, System, Optimization, Business
@@ -67,26 +64,4 @@ The outputs of GEMS consist of three main categories of objects: **Optimization
 
 - **Optimization Problem** represents the global mathematical formulation of the energy system simulation/optimization.
 - **Simulation Table** contains the raw results of the simulation or optimization, including the optimal values of decision variables and the values of expressions computed from them.
-- **Business Views** provide curated representations of the simulation or optimization results from a business-intelligence perspective, tailored to users [specific needs](../3_User_Guide/5_Outputs/3_business_view.md).
-
----
-
-**Navigation**
-
-<div style="display: flex; justify-content: space-between;">
-  <div style="text-align: left;">
-  <button type="button" style="background-color:#CCCCCC; border:none; padding:8px 16px; border-radius:4px; cursor:pointer">
-    <a href="../1_Architecture" style="text-decoration:none; color: #000000">⬅️ Previous page</a>
-  </button>
-  </div>
-  <button type="button" style="background-color:#AAAAFF; border:none; padding:8px 16px; border-radius:4px; cursor:pointer">
-    <a href="../../../.." style="text-decoration:none; color: #FFFFFF">Home</a>
-  </button>
-  <div style="text-align: right;">
-  <button type="button" style="background-color:#CCCCCC; border:none; padding:8px 16px; border-radius:4px; cursor:pointer">
-    <a href="../3_Difference_with_other_languages" style="text-decoration:none; color: #000000">Next page ➡️</a>
-  </button>
-  </div>
-</div>
-
----
+- **Business Views** provide curated representations of the simulation or optimization results from a business-intelligence perspective, tailored to users [specific needs](../3_User_Guide/5_Outputs/3_business_view.md).