feat: add what's new section

doc/source/conf.py

@@ -183,6 +183,7 @@
     "github_repo": "pymechanical",
     "github_version": "main",
     "doc_path": "doc/source",
+    # "whatsnew": [{'title': 'v0.11.x', 'children': 'Open the project files with Mechanical GUI.', 'url': ''}, {'title': 'v0.10.x', 'children': 'Visualize imported geometry in 3D. This feature is available only from 24R1 or later.', 'url': ''}]
 }
 html_theme_options = {
     "logo": "pyansys",
@@ -213,6 +214,10 @@
     },
     "ansys_sphinx_theme_autoapi": {"project": project, "templates": "_templates/autoapi"},
     "navigation_depth": 10,
+    "whatsnew": {
+        "file": "whatsnew",
+        "pages": ["index"],
+    }
 }
 
 # -- Options for HTMLHelp output ---------------------------------------------
@@ -224,6 +229,7 @@
     "changelog": [],
     "examples/index": [],
     "contributing": [],
+    "index": ["sidebar-nav-bs.html"],
 }
 
 html_show_sourcelink = False

doc/source/index.rst

@@ -14,7 +14,6 @@
    :width: 580px
    :align: center
 
-
 Python API to interact with `Ansys Mechanical`_ (FEA software for structural engineering) from **2023R2** and later versions.
 
 .. grid:: 3
@@ -118,4 +117,5 @@ Python API to interact with `Ansys Mechanical`_ (FEA software for structural eng
    contributing
    kil/index
    faq
-   changelog
+   changelog
+   whatsnew

doc/source/whatsnew.rst

@@ -0,0 +1,43 @@
+.. _ref_whatsnew:
+
+What's new
+==========
+
+Discover the latest updates in PyMechanical, including new features,
+performance enhancements, and bug fixes designed to improve your experience.
+
+v0.11.x
+-------
+
+Launch GUI
+^^^^^^^^^^
+
+Open the project files with Mechanical GUI.
+
+.. code:: python
+
+  launch_gui()
+
+Opens up the saved ``.mechdb`` or ``.mechdat`` files.
+
+
+v0.10.x
+-------
+
+Visualize geometry in 3D
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Visualize imported geometry in 3D. This feature is available only from 24R1 or later.
+
+.. code:: python
+
+  import ansys.mechanical.core as mech
+  from ansys.mechanical.core.examples import delete_downloads, download_file
+
+  app = mech.App(version=242)
+  app.update_globals(globals())
+
+  # Import the geometry
+
+  # visualize
+  app.plot()

pyproject.toml

@@ -55,7 +55,7 @@ tests = [
 ]
 doc = [
     "sphinx==8.0.2",
-    "ansys-sphinx-theme[autoapi]==1.1.2",
+    "ansys-sphinx-theme[autoapi] @ git+https://github.com/ansys/ansys-sphinx-theme.git@fix/whatsnew",
     "grpcio==1.66.2",
     "imageio-ffmpeg==0.5.1",
     "imageio==2.35.1",