fix: Doc review suggestions

Author: AlejandroFernandezLuces

doc/source/user_guide/index.rst

@@ -46,7 +46,7 @@ Use with PyAnsys custom objects
 
 You can also use the default plotter to visualize PyAnsys custom objects. The only requirement is that the
 custom object must have a method that returns a PyVista mesh a method that exposes a ``name`` or
-``id`` attribute of your object. To expose a custom object, you use a ``MeshObjectPlot`` instance. This class
+``id`` attribute of your object. To expose a custom object, you use a :class:`~ansys.tools.visualization_interface.types.mesh_object_plot.MeshObjectPlot` instance. This class
 relates PyVista meshes with any object.
 
 The following code shows how to use the default plotter to visualize a PyAnsys custom object:
@@ -100,7 +100,7 @@ class. After that, see these main use cases for customizing the plotter:
 * The most common use case is to customize the way that the objects you represent are shown in the plotter.
   To this end, you can override the ``plot`` and ``plot_iter`` methods. These methods are called every time
   a new object is added to the plotter. The default implementation of this method is to add a PyVista mesh
-  or a  ``MeshObjectPlot`` instance to the plotter. You can override this method to add your own meshes or
+  or a :class:`~ansys.tools.visualization_interface.types.mesh_object_plot.MeshObjectPlot` instance to the plotter. You can override this method to add your own meshes or
   objects to the plotter in a manner that fits the way that you want to represent the meshes.
 
 * Another use case is the need to have custom button functionalities for your library. For example, you may
@@ -116,11 +116,11 @@ For comprehensive migration information with code examples, see :ref:`ref_migrat
 Customizing the picker and hover callbacks
 ==========================================
 
-The Visualization Interface Tool provides a base class, ``AbstractPicker``, for customizing the picker and hover
+The Visualization Interface Tool provides a base class, :class:`~ansys.tools.visualization_interface.backends.pyvista.picker.AbstractPicker`, for customizing the picker and hover
 callbacks of the plotter. This class provides a set of methods that can be overridden so that you can adapt the
 picker and hover functionalities to the specific need of your PyAnsys library.
 
-The first thing you must do is to create a class that inherits from the ``AbstractPicker`` class. After that, see
+The first thing you must do is to create a class that inherits from the :class:`~ansys.tools.visualization_interface.backends.pyvista.picker.AbstractPicker` class. After that, see
 these main use cases for customizing the picker and hover callbacks:
 
 * You may want to change the way that objects are picked in the plotter. To do this, you can override the
@@ -131,4 +131,4 @@ these main use cases for customizing the picker and hover callbacks:
   override the ``hover_select_object`` and ``hover_unselect_object`` methods. These methods are called when an
   object is hovered over or unhovered, respectively.
 
-A practical example of how to use the ``AbstractPicker`` class are included in the examples section of the documentation.
+A practical example of how to use the :class:`~ansys.tools.visualization_interface.backends.pyvista.picker.AbstractPicker` class is included in :ref:`sphx_glr_examples_00-basic-pyvista-examples_custom_picker.py`.

doc/source/user_guide/migration.rst

@@ -3,7 +3,11 @@
 Migration
 #########
 
-In this section two guides are provided to help you migrate from PyVista plotters to the Ansys Tools Visualization Interface plotters.
+This section helps you migrate from PyVista plotters to the Ansys Tools Visualization Interface plotters.
+It consists of two major topics:
+
+- `Code migration`_
+- `Documentation configuration migration`_
 
 Code migration
 ==============
@@ -73,7 +77,7 @@ Your custom object must have a method that returns a PyVista mesh and a method t
             return self.name
 
 
-You then need to create a ``MeshObjectPlot`` instance that relates the PyVista mesh with your custom object:
+You then need to create a :class:`~ansys.tools.visualization_interface.types.mesh_object_plot.MeshObjectPlot` instance that relates the PyVista mesh with your custom object:
 
 .. code-block:: python
 
@@ -109,7 +113,7 @@ You can customize the backend of the Ansys Tools Visualization Interface plotter
     # Show the plotter
     pl.show()
 
-If you want to customize the backend even more, you can create your own backend by inheriting from the ``PyVistaBackendInterface`` class
+If you want to customize the backend even more, you can create your own backend by inheriting from the :class:`~ansys.tools.visualization_interface.backends.pyvista.PyVistaBackendInterface` class
 and implementing the required methods:
 
 .. code-block:: python
@@ -150,14 +154,15 @@ and implementing the required methods:
         pass
 
 
-The rest of the methods are implemented for you. This ensures that while you can customize what you need for plotting, the rest of the functionalities still work as expected.
-If you need to even go further, you can create your own plotter by inheriting from the ``BaseBackend`` class and implementing the required methods,
-although this may break existing features. You can find more information about this in the plotter documentation.
+The rest of the methods are implemented for you. This ensures that while you can customize what you need for plotting, 
+the rest of the functionalities still work as expected. For more information, see the backend documentation. If you 
+need to even go further, you can create your own plotter by inheriting from the :class:`~ansys.tools.visualization_interface.backends._base.BaseBackend` class and implementing the required methods,
+although this may break existing features.
 
 Customize the picker or hover behavior
 --------------------------------------
 You can customize the picker of the Ansys Tools Visualization Interface plotter to decide what happens when you pick or hover over an object.
-For example, if you want to print the name of the picked object, you can do it as described in the custom picker example.
+For example, if you want to print the name of the picked object, you can do it as described in the :ref:`sphx_glr_examples_00-basic-pyvista-examples_custom_picker.py` example.
 
 Use the PyVista Qt backend
 --------------------------

src/ansys/tools/visualization_interface/backends/pyvista/pyvista.py

@@ -509,7 +509,7 @@ def plot_iter(self, plottable_object: Any, name_filter: str = None, **plotting_o
         plottable_object : Any
             One or more objects to add.
         name_filter : str, default: None.
-            Regular expression with the desired name or names  to include in the plotter.
+            Regular expression with the desired name or names to include in the plotter.
         **plotting_options : dict, default: None
             Keyword arguments. For allowable keyword arguments, see the
             :meth:`Plotter.add_mesh <pyvista.Plotter.add_mesh>` method.
@@ -524,7 +524,7 @@ def plot(self, plottable_object: Any, name_filter: str = None, **plotting_option
         Parameters
         ----------
         plottable_object : Any
-            Object to add.
+            Object to plot.
         name_filter : str
             Regular expression with the desired name or names to include in the plotter.
         **plotting_options : dict, default: None
@@ -618,7 +618,7 @@ def plot(self, plottable_object: Any, name_filter: str = None, **plotting_option
         Parameters
         ----------
         plottable_object : Any
-            Object to add.
+            Object to plot.
         name_filter : str
             Regular expression with the desired name or names to include in the plotter.
         **plotting_options : dict, default: None