Add custom Python operator and plugin tutorials

doc/source/conf.py

@@ -87,6 +87,7 @@
     "sphinx_design",
     "sphinx_gallery.gen_gallery",
     'sphinx_reredirects',
+    "jupyter_sphinx",
 ]
 
 redirects = {

doc/source/user_guide/how_to.rst

@@ -15,15 +15,6 @@ How-tos
 
        .. image:: ../images/plotting/pontoon.png
        .. image:: ../images/plotting/pontoon_strain.png
-
-
-    .. grid-item-card:: Create custom operators
-       :link: user_guide_custom_operators
-       :link-type: ref
-       :text-align: center
-
-       .. image:: ../images/drawings/plugin-logo.png
-          :width: 50%
 
 
     .. grid-item-card:: Use DPF Server package

doc/source/user_guide/index.rst

@@ -4,24 +4,24 @@
 User guide
 ==========
 
-PyDPF-Core is a Python client API for accessing DPF postprocessing
-capabilities. The ``ansys.dpf.core`` package makes highly efficient 
-computation, customization, and remote postprocessing accessible in Python.
+**DPF** provides numerical simulation users and engineers with a toolbox for accessing and
+transforming data.
 
-The goals of this section are to:
+**PyDPF-Core** is a Python client API for accessing DPF
+capabilities. The ``ansys.dpf.core`` package makes highly efficient
+computation, customization, and remote data processing accessible in Python.
 
- - Describe the most-used DPF entities and how they can help you to access and modify solver data.
- - Provide simple how-tos for tackling the most common use cases.
+The goals of this section are to:
 
-.. include::
-   concepts/index.rst
+ - Describe some DPF entities and how they can help you to access and modify solver data.
+ - Provide detailed tutorials to demonstrate PyDPF-Core functionalities.
+ - Explain how to resolve the most common issues encountered when using PyDPF-Core
 
 .. include::
-   main_entities.rst
+   tutorials/index.rst
 
 .. include::
-   how_to.rst
-
+   concepts/index.rst
 
 Troubleshooting
 ---------------
@@ -52,6 +52,25 @@ Troubleshooting
        :text-align: center
 
 
+.. toctree::
+    :maxdepth: 2
+    :hidden:
+    :caption: Tutorials
+
+    tutorials/data_structures/index.rst
+    tutorials/language_and_usage/index.rst
+    tutorials/post_processing_basics/index.rst
+    tutorials/import_data/index.rst
+    tutorials/mesh/index.rst
+    tutorials/transform_data/index.rst
+    tutorials/export_data/index.rst
+    tutorials/plot/index.rst
+    tutorials/animate/index.rst
+    tutorials/custom_operators_and_plugins/index.rst
+    tutorials/distributed_files/index.rst
+    tutorials/dpf_server/index.rst
+    tutorials/licensing/index.rst
+
 .. toctree::
    :maxdepth: 2
    :hidden:
@@ -61,30 +80,6 @@ Troubleshooting
    concepts/waysofusing.rst
    concepts/stepbystep.rst
 
-
-.. toctree::
-    :maxdepth: 2
-    :hidden:
-    :caption: DPF most-used entities
-
-    model
-    operators
-    fields_container
-
-
-.. toctree::
-    :maxdepth: 2
-    :hidden:
-    :caption: How-tos
-
-    plotting.rst
-    custom_operators.rst
-    dpf_server.rst
-    server_types.rst
-    server_context.rst
-    xmlfiles.rst
-
-
 .. toctree::
     :maxdepth: 3
     :hidden:

doc/source/user_guide/tutorials/animate/index.rst

@@ -0,0 +1,24 @@
+.. _ref_tutorials_animate:
+
+=======
+Animate
+=======
+
+These tutorials demonstrate how to visualise the data in an animation.
+
+.. grid:: 1 1 3 3
+    :gutter: 2
+    :padding: 2
+    :margin: 2
+
+    .. grid-item-card:: Animate data
+       :link: ref_tutorials
+       :link-type: ref
+       :text-align: center
+
+       This tutorial
+
+.. toctree::
+    :maxdepth: 2
+    :hidden:
+