fix: doc issues

Author: AlejandroFernandezLuces

examples/01-basic-plotly-examples/README.txt

@@ -0,0 +1,4 @@
+Basic Plotly usage examples
+===========================
+
+These examples show how to use the general plotter with Plotly backend included in the Visualization Interface Tool.

examples/01-basic-plotly-examples/plain-usage.py

@@ -19,13 +19,24 @@
 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
+"""
+.. _ref_plain_usage_plotly:
+
+=================================
+Plain usage of the plotly backend
+=================================
+
+This example shows the plain usage of the Plotly backend in the Visualization Interface Tool to plot different objects,
+including PyVista meshes, custom objects, and Plotly-specific objects.
+"""
 
 from ansys.tools.visualization_interface.backends.plotly.plotly_interface import PlotlyBackend
 from ansys.tools.visualization_interface.types import MeshObjectPlot
 from ansys.tools.visualization_interface import Plotter
 import pyvista as pv
 from plotly.graph_objects import Mesh3d
 
+
 # Create a plotter with the Plotly backend
 pl = Plotter(backend=PlotlyBackend())
 
@@ -35,8 +46,12 @@
 # Plot the mesh
 pl.plot(mesh)
 
+#####################
 # Display the plotter
-pl.show()
+#
+# code-block:: python
+#
+#   pl.show()
 
 # Now create a custom object
 class CustomObject:
@@ -62,8 +77,14 @@ def name(self):
 # Plot the custom mesh object
 pl.plot(mesh_object_cube)
 
-# Since Plotly is a web-based visualization, we can show the plot again to include the new object
-pl.show()
+###########################
+# Display the plotter again
+# =========================
+# Since Plotly is a web-based visualization, we can show the plot again to include the new object.
+#
+# code-block:: python
+#
+#   pl.show()
 
 # Add a Plotly Mesh3d object directly
 custom_mesh3d = Mesh3d(
@@ -77,7 +98,6 @@ def name(self):
     opacity=0.50
 )
 pl.plot(custom_mesh3d)
-pl.show()
 
 # Show other plotly objects like Scatter3d
 from plotly.graph_objects import Scatter3d
@@ -90,4 +110,11 @@ def name(self):
     marker=dict(size=5, color='red')
 )
 pl.plot(scatter)
-pl.show()
+
+###########################
+# Display the plotter again
+# =========================
+#
+# code-block:: python
+#
+#   pl.show()

src/ansys/tools/visualization_interface/backends/plotly/__init__.py

@@ -0,0 +1,22 @@
+# Copyright (C) 2024 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+"""Plotly initialization."""