updates on the index cards

luisaFelixSalles · luisaFelixSalles · commit db55259583f4 · 2024-11-12T10:59:03.000+01:00
diff --git a/doc/source/user_guide/tutorials/00-overview.rst b/doc/source/user_guide/tutorials/00-overview.rst
diff --git a/doc/source/user_guide/tutorials/01-language_and_usage/index.rst b/doc/source/user_guide/tutorials/01-language_and_usage/index.rst
@@ -5,7 +5,10 @@ PyDPF-Core language and usage
 =============================
 
 This tutorial gives you an overview on how the the PyDPF-COre API can be used.
-For more detailed information on each module and function, see :ref:`api_section`.
+Here you will learn the different ways to interact with data by calling PyDPF-Core
+commands and operators.
+
+For more detailed information on each module and function, see :ref:`ref_api_section`.
 
 
 
diff --git a/doc/source/user_guide/tutorials/04-import_data/index.rst b/doc/source/user_guide/tutorials/04-import_data/index.rst
@@ -4,10 +4,13 @@
 Import Data
 ===========
 
+These tutorials demonstrate how to represent data in DPF: either from manual input either
+form simulation result files.
+
 From user input
 ***************
 
-.. grid:: 2
+.. grid:: 1 1 3 3
     :gutter: 2
     :padding: 2
     :margin: 2
diff --git a/doc/source/user_guide/tutorials/05-mesh/index.rst b/doc/source/user_guide/tutorials/05-mesh/index.rst
@@ -4,7 +4,7 @@
 Mesh
 ====
 
-.. grid:: 2
+.. grid:: 1 1 3 3
     :gutter: 2
     :padding: 2
     :margin: 2
diff --git a/doc/source/user_guide/tutorials/06-transform_data/index.rst b/doc/source/user_guide/tutorials/06-transform_data/index.rst
@@ -4,7 +4,7 @@
 Transform data
 ==============
 
-.. grid:: 2
+.. grid:: 1 1 3 3
     :gutter: 2
     :padding: 2
     :margin: 2
diff --git a/doc/source/user_guide/tutorials/07-export_data/index.rst b/doc/source/user_guide/tutorials/07-export_data/index.rst
@@ -4,7 +4,7 @@
 Export data
 ===========
 
-.. grid:: 2
+.. grid:: 1 1 3 3
     :gutter: 2
     :padding: 2
     :margin: 2
diff --git a/doc/source/user_guide/tutorials/08-plot/index.rst b/doc/source/user_guide/tutorials/08-plot/index.rst
@@ -4,7 +4,7 @@
 Plot
 ====
 
-.. grid:: 2
+.. grid:: 1 1 3 3
     :gutter: 2
     :padding: 2
     :margin: 2
diff --git a/doc/source/user_guide/tutorials/09-animate/index.rst b/doc/source/user_guide/tutorials/09-animate/index.rst
@@ -4,7 +4,7 @@
 Animate
 =======
 
-.. grid:: 2
+.. grid:: 1 1 3 3
     :gutter: 2
     :padding: 2
     :margin: 2
diff --git a/doc/source/user_guide/tutorials/10-enriching_dpf_capabilities/index.rst b/doc/source/user_guide/tutorials/10-enriching_dpf_capabilities/index.rst
@@ -4,7 +4,7 @@
 Enriching DPF capabilities
 ==========================
 
-.. grid:: 2
+.. grid:: 1 1 3 3
     :gutter: 2
     :padding: 2
     :margin: 2
diff --git a/doc/source/user_guide/tutorials/11-distributed_files/index.rst b/doc/source/user_guide/tutorials/11-distributed_files/index.rst
@@ -4,7 +4,7 @@
 Post-process distributed files
 ==============================
 
-.. grid:: 2
+.. grid:: 1 1 3 3
     :gutter: 2
     :padding: 2
     :margin: 2
diff --git a/doc/source/user_guide/tutorials/12-dpf_server/index.rst b/doc/source/user_guide/tutorials/12-dpf_server/index.rst
@@ -4,7 +4,7 @@
 DPF server
 ==========
 
-.. grid:: 2
+.. grid:: 1 1 3 3
     :gutter: 2
     :padding: 2
     :margin: 2
diff --git a/doc/source/user_guide/tutorials/13-licensing/index.rst b/doc/source/user_guide/tutorials/13-licensing/index.rst
@@ -4,7 +4,7 @@
 Licensing
 =========
 
-.. grid:: 2
+.. grid:: 1 1 3 3
     :gutter: 2
     :padding: 2
     :margin: 2
diff --git a/doc/source/user_guide/tutorials/basic_tutorial_index.rst b/doc/source/user_guide/tutorials/basic_tutorial_index.rst
diff --git a/doc/source/user_guide/tutorials/index.rst b/doc/source/user_guide/tutorials/index.rst
@@ -7,6 +7,12 @@ The tutorials cover specifics features with detailed demonstrations to help
 understanding the fundamental PyDPF-Core functionalities and clarify some concepts.
 They are designed to teach how to perform a task, providing explanations at each stage.
 
+It helps to have a Python interpreter for hands-on experience, but all code examples are
+executed, so the tutorial can be read off-line as well.
+
+For a complete description of all the objects and modules, see the :ref:`API reference <ref_api_section>`
+section.
+
 :fa:`person-running` Beginner's guide
 *************************************
 
@@ -23,22 +29,24 @@ of our package background so you can understand how to work with it.
        :link-type: ref
        :text-align: center
 
-       These tutorials gives you an overview on how to use PyDPF-Core API
+       Check an overview on how to use PyDPF-Core API.
+       Learn the different ways to interact with data by calling PyDPF-Core
+       classes and operators.
 
     .. grid-item-card::  Processing data basics
        :link: ref_tutorials_processing_basics
        :link-type: ref
        :text-align: center
 
-       These tutorials shows the basics on how data can be manipulated with PyDPF-Core:
+       Learn the basics on how data can be manipulated with PyDPF-Core:
        How to create data storage structures, basic mathematics with the data...
 
     .. grid-item-card::  Post processing simulations basics
        :link: ref_tutorials_post_processing_basics
        :link-type: ref
        :text-align: center
 
-       This tutorial shows a basic post-processing procedure using PyDPf-Core
+       Check a basic post-processing procedure using PyDPf-Core.
 
 :fa:`book-open-reader` Features usage
 *************************************
@@ -53,68 +61,67 @@ of our package background so you can understand how to work with it.
        :link-type: ref
        :text-align: center
 
-       These tutorials demonstrate how to represent data in DPF: either from manual input either form result files.
+       Understand how to represent data in DPF: either from manual input either form result files.
 
-    .. grid-item-card:: Export data from DPF
-       :link: ref_tutorials_export_data
+    .. grid-item-card:: Mesh analysis
+       :link: ref_tutorials_mesh
        :link-type: ref
        :text-align: center
 
-       These tutorials provides demonstrations on how to export data from your manipulation.
+       Learn how to explore the simulation models mesh.
 
     .. grid-item-card:: Transform data with PyDPF-Core
        :link: ref_tutorials_transform_data
        :link-type: ref
        :text-align: center
 
-       These tutorials demonstrate how to transform and operate on the data to obtain the desired input.
+       Learn how to transform and operate on data to obtain the desired input.
 
-    .. grid-item-card:: Mesh analysis
-       :link: ref_tutorials_mesh
+    .. grid-item-card:: Export data from DPF
+       :link: ref_tutorials_export_data
        :link-type: ref
        :text-align: center
 
-       These tutorials provides detailed demonstrations on how to explore the simulation models mesh.
+       Discover the best ways to export data from your manipulation.
 
     .. grid-item-card:: Plot
        :link: ref_tutorials_plot
        :link-type: ref
        :text-align: center
 
-       These tutorials shows how to visualise the data in plots.
+       Explore the different approaches to visualise the data in plots.
 
     .. grid-item-card:: Animate
        :link: ref_tutorials_animate
        :link-type: ref
        :text-align: center
 
-       These tutorials shows how to visualise the data in an animation.
+       Explore the different approaches to visualise the data in an animation.
 
     .. grid-item-card:: Enriching DPF capabilities
        :link: ref_tutorials_enriching
        :link-type: ref
        :text-align: center
 
-       These tutorials demonstrate how to enhance DPF capabilities by creating new operator’s libraries.
+       Discover how to enhance DPF capabilities by creating new operator’s libraries.
 
     .. grid-item-card:: Post-process distributed files
        :link: ref_tutorials_distributed_files
        :link-type: ref
        :text-align: center
 
-       These tutorials provides demonstrations on how to use PyDPF-Core with distributed files.
+       Learn how to use PyDPF-Core with distributed files.
 
     .. grid-item-card:: DPF server
        :link: ref_tutorials_dpf_server
        :link-type: ref
        :text-align: center
 
-       These tutorial explains how to manipulate DPF client-server architecture
+       Understand how to manipulate DPF client-server architecture
 
     .. grid-item-card:: Licensing
        :link: ref_tutorials_licensing
        :link-type: ref
        :text-align: center
 
-       These tutorials provide detailed demonstrations on how to access
-       the Entry and Premium licensing capabilities
+       Understand how to access the Entry and Premium licensing capabilities
