Merge branch 'main' into fix/issue_6710

Author: Samuelopez-ansys

doc/changelog.d/6732.fixed.md

@@ -0,0 +1 @@
+Version manager pip fallback

doc/changelog.d/6738.fixed.md

@@ -0,0 +1 @@
+Enable to import the lib again from MacOS

doc/source/User_guide/pyaedt_extensions_doc/project/version_manager.rst

@@ -1,22 +1,65 @@
 The extension allows users to update PyAEDT and PyEDB through GUI
 -----------------------------------------------------------------
 
-.. image:: ../../../_static/extensions/version_manager.png
+.. image:: ../../../_static/extensions/version_manager_basic.png
   :width: 800
-  :alt: Version manager
-
-----------
-Features
-----------
-
-- Show Python virtual environment path
-- Show Python version
-- Show the current PyAEDT and PyEDB versions
-- Show the latest PyAEDT and PyEDB release available on PyPI
-- Update PyAEDT and PyEDB to the latest version on PyPI
-- Install PyAEDT and PyEDB with a branch available on Github
-    - By default the main development branch is used
-    - Other existing branch names can be provided
-- Update PyAEDT and PyEDB from wheelhouse
-  - Check compatibility
-- Reset and update PyAEDT buttons in AEDT
+  :alt: Version manager basic
+
+.. image:: ../../../_static/extensions/version_manager_advanced.png
+  :width: 800
+  :alt: Version manager advanced
+
+Overview
+========
+A lightweight panel to view your Python environment and manage the two core
+packages: ``pyaedt`` and ``pyedb``. It lets you see what is installed, compare
+with the latest PyPI releases, update (or downgrade to the latest official
+release), install from a Git branch, or install from a wheelhouse ZIP.
+
+Main actions
+============
+- Show virtual environment path and Python version
+- Show installed and latest PyPI versions of ``pyaedt`` and ``pyedb``
+- Update one or both packages (Update / Update All)
+- Install a package from a Git branch
+- Install ``pyaedt`` from a validated wheelhouse ZIP
+- Reset PyAEDT buttons inside AEDT
+- Open help page (Help button)
+
+Tabs
+====
+Basic: Versions, Update buttons, Update All, Wheelhouse install.
+
+Advanced: Git branch install fields and Reset AEDT panels.
+
+Quick: Install from Git branch
+==============================
+1. Go to Advanced tab.
+2. Enter branch name (default is ``main``).
+3. Click Get Branch and confirm.
+
+Quick: Update from wheelhouse
+=============================
+1. Click Update from wheelhouse (Basic tab).
+2. Pick the wheelhouse ZIP.
+3. If compatible, it installs new ``pyaedt[all]`` and refreshes the panels.
+
+Notes
+=====
+- Uses ``uv pip`` when available; falls back to ``python -m pip`` automatically.
+- Git must be on PATH for branch installs.
+- Wheelhouse ZIP must match Python version and OS.
+- A downgrade occurs only if your installed version is newer than the latest
+  release on PyPI.
+
+Troubleshooting
+===============
+- Missing buttons after update: Reset AEDT panels (Advanced tab).
+- PyPI lookup fails: check network / proxy and retry.
+- Git branch install fails: verify branch name and that Git is installed.
+- Wheelhouse rejected: confirm Python version and OS match.
+
+Disclaimer
+==========
+A confirmation dialog appears before any install or update involving
+third-party/open-source software. Proceed only if you accept the terms.