feat: add what's new section

doc/changelog.d/945.added.md

@@ -0,0 +1 @@
+add what's new section

doc/changelog.d/whatsnew/123.whatsnew.rst

@@ -0,0 +1,21 @@
+Launch GUI
+^^^^^^^^^^
+Open the current project with Mechanical GUI.
+
+.. code:: python
+
+    from ansys.mechanical.core import App
+
+    app = App()
+    app.save()
+    app.launch_gui()
+
+Above code opens up the temporarily saved ``.mechdb`` or ``.mechdat`` files.
+The files are deleted when GUI is closed . For more info check
+`launch_gui() <../api/ansys/mechanical/core/embedding/launch_gui/index.html>`_ function
+
+Opens up the specified project file.
+
+.. code:: python
+
+  launch_gui("path/to/project.mechdb")

doc/changelog.d/whatsnew/456.whatsnew.rst

@@ -0,0 +1,12 @@
+Prints mechanical project tree
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+This feature let you see the hierarchy of the mechanical project.
+It also shows whether an object is suppressed or not.
+
+.. code:: python
+
+  import ansys.mechanical.core as mech
+
+  app = mech.App()
+  app.update_globals(globals())
+  app.print_tree()

doc/source/changelog.rst

@@ -1,5 +1,15 @@
+:orphan:
+
 .. _ref_release_notes:
 
+.. button-ref:: release-note
+    :ref-type: doc
+    :color: primary
+    :shadow:
+    :expand:
+
+    Go to new release notes
+
 Release notes
 #############
 

doc/source/conf.py

@@ -207,12 +207,16 @@
             "icon": "fa fa-comment fa-fw",
         },
     ],
-    "cheatsheet": {
-        "file": "cheatsheet/cheat_sheet.qmd",
-        "title": "PyMechanical cheat sheet",
-    },
+    # "cheatsheet": {
+    #     "file": "cheatsheet/cheat_sheet.qmd",
+    #     "title": "PyMechanical cheat sheet",
+    # },
     "ansys_sphinx_theme_autoapi": {"project": project, "templates": "_templates/autoapi"},
     "navigation_depth": 10,
+    "whatsnew": {
+        "file": "release-note",
+        "pages": ["index", "release-note"],
+    },
 }
 
 # -- Options for HTMLHelp output ---------------------------------------------

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
+   release-note
+   whatsnew

doc/source/whatsnew.rst

@@ -0,0 +1,79 @@
+.. _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 current project with Mechanical GUI.
+
+.. code:: python
+
+    from ansys.mechanical.core import App
+
+    app = App()
+    app.save()
+    app.launch_gui()
+
+Above code opens up the temporarily saved ``.mechdb`` or ``.mechdat`` files.
+The files are deleted when GUI is closed . For more info check
+`launch_gui() <../api/ansys/mechanical/core/embedding/launch_gui/index.html>`_ function
+
+Opens up the specified project file.
+
+.. code:: python
+
+  launch_gui("path/to/project.mechdb")
+
+Prints Mechanical project tree
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+This feature let you see the heirachial Mechanical project tree.
+It also shows whether an object is suppressed or not.
+
+.. code:: python
+
+  import ansys.mechanical.core as mech
+
+  app = mech.App()
+  app.update_globals(globals())
+  app.print_tree()
+
+.. code:: shell
+
+  ... ├── Project
+  ... |  ├── Model
+  ... |  |  ├── Geometry Imports
+  ... |  |  ├── Geometry
+  ... |  |  ├── Materials
+  ... |  |  ├── Coordinate Systems
+  ... |  |  |  ├── Global Coordinate System
+  ... |  |  ├── Remote Points
+  ... |  |  ├── Mesh
+
+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
+
+  app = mech.App(version=242)
+  app.update_globals(globals())
+
+  # Import the geometry
+
+  # visualize
+  app.plot()

pyproject.toml

@@ -57,8 +57,8 @@ tests = [
 ]
 doc = [
     "sphinx==8.1.3",
-    "ansys-sphinx-theme[autoapi]==1.2.0",
-    "grpcio==1.67.1",
+    "ansys-sphinx-theme[autoapi] @ git+https://github.com/ansys/ansys-sphinx-theme.git@fix/jinja-template-testing",
+    "grpcio==1.66.2",
     "imageio-ffmpeg==0.5.1",
     "imageio==2.36.0",
     "jupyter_sphinx==0.5.3",
@@ -156,25 +156,26 @@ xfail_strict = true
 [tool.towncrier]
 package = "ansys.mechanical.core"
 directory = "doc/changelog.d"
-filename = "doc/source/changelog.rst"
+filename = "doc/source/release-note.rst"
 start_string = ".. towncrier release notes start\n"
-template = "doc/changelog.d/changelog_template.jinja"
-title_format = "`{version} <https://github.com/ansys/pymechanical/releases/tag/v{version}>`_ - {project_date}"
+template = "ansys_sphinx_theme:changelog_template.jinja"
+title_format = "Version `{version} <https://github.com/ansys/pymechanical/releases/tag/v{version}>`_ ({project_date})"
 issue_format = "`#{issue} <https://github.com/ansys/pymechanical/pull/{issue}>`_"
+all_bullets = false
 
 [[tool.towncrier.type]]
 directory = "added"
-name = "Added"
+name = "Features"
 showcontent = true
 
 [[tool.towncrier.type]]
 directory = "changed"
-name = "Changed"
+name = "Deprecated and Changed"
 showcontent = true
 
 [[tool.towncrier.type]]
 directory = "fixed"
-name = "Fixed"
+name = "Bug fixes"
 showcontent = true
 
 [[tool.towncrier.type]]
@@ -187,6 +188,19 @@ directory = "miscellaneous"
 name = "Miscellaneous"
 showcontent = true
 
+[[tool.towncrier.type]]
+directory = "whatsnew"
+name = "Whatsnew"
+showcontent = true
+
+[[tool.towncrier.section]]
+name = ""
+path = ""
+
+[[tool.towncrier.section]]
+name = "Whatsnew"
+path = "whatsnew"
+
 # ========================================================
 # Flake8 Configuration
 # ========================================================