Add custom Python operator and plugin tutorials (#1890)

Co-authored-by: Paul Profizi <[email protected]>
Co-authored-by: PProfizi <[email protected]>

Author: luisaFelixSalles

doc/source/conf.py

@@ -135,6 +135,7 @@
 
 autosummary_generate = False
 
+autodoc_mock_imports = ["ansys.dpf.core.examples.python_plugins"]
 
 # Add any paths that contain templates here, relative to this directory.
 # templates_path = ['_templates']

doc/source/user_guide/custom_operator_example.py

@@ -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/custom_operators.rst

@@ -66,7 +66,7 @@ Troubleshooting
     tutorials/export_data/index.rst
     tutorials/plot/index.rst
     tutorials/animate/index.rst
-    tutorials/enriching_dpf_capabilities/index.rst
+    tutorials/custom_operators_and_plugins/index.rst
     tutorials/distributed_files/index.rst
     tutorials/dpf_server/index.rst
     tutorials/licensing/index.rst

doc/source/user_guide/how_to.rst

@@ -56,16 +56,19 @@ The library of DPF operators is large and includes file readers and mathematical
 geometrical, and logical transformations. For more information on this library,
 which is progressively enhanced, see :ref:`ref_dpf_operators_reference`.
 
+Despite the large number of operators proposed by the standard DPF installation, you may want to
+create your own operators and ship them as DPF plugins.
+See the tutorials section on custom operators and plugins to learn more.
 
-Create operators
-~~~~~~~~~~~~~~~~
-Each operator is of type :py:mod:`Operator <ansys.dpf.core.dpf_operator>`. You can create an instance 
+Instantiate operators
+~~~~~~~~~~~~~~~~~~~~~
+Each operator is of type :py:mod:`Operator <ansys.dpf.core.dpf_operator>`. You can instantiate an operator
 in Python with any of the derived classes available in the
 :py:mod:`ansys.dpf.core.operators` package or directly with the :py:mod:`Operator <ansys.dpf.core.dpf_operator>`
 class using the internal name string that indicates the operator type. 
 For more information, see :ref:`ref_dpf_operators_reference`.
 
-This example shows how to create the displacement operator:
+This example shows how to instantiate the displacement operator:
 
 .. code-block:: python