Refresh docs for flattened dartpy API

Author: jslee02

docs/onboarding/README.md

@@ -561,7 +561,7 @@ graph TB
 - `dartpy` (top-level) - Core classes/functions (math, dynamics, collision, simulation, constraint, optimizer) exposed in snake_case
 - `dartpy.io` - File parsers (URDF, SDF, SKEL, MJCF) [alias for legacy `utils`]
 - `dartpy.gui` - 3D visualization with OSG and ImGui
-- Legacy `dartpy.common`/`math`/`dynamics`/`collision`/`simulation`/`constraint`/`optimizer`/`utils` remain importable in DART 7.x but emit `DeprecationWarning` and will be removed in DART 8.0.
+- Legacy `dartpy`/`math`/`dynamics`/`collision`/`simulation`/`constraint`/`optimizer`/`utils` remain importable in DART 7.x but emit `DeprecationWarning` and will be removed in DART 8.0.
 
 **Key Files**:
 
@@ -818,7 +818,7 @@ sequenceDiagram
     Python->>dartpy: world = dartpy.World()
     dartpy->>DART: World::create()
 
-    Python->>dartpy: skel = dartpy.dynamics.Skeleton.create()
+    Python->>dartpy: skel = dartpy.Skeleton.create()
     dartpy->>DART: Skeleton::create()
 
     Python->>dartpy: world.add_skeleton(skel)

docs/python_api/modules/collision.rst

@@ -1,7 +1,7 @@
-dartpy.collision
-================
+dartpy
+======
 
-.. automodule:: dartpy.collision
+.. note:: Legacy submodules will be removed in DART 8.0; use top-level `dartpy`.
+
+.. automodule:: dartpy
    :members:
-   :undoc-members:
-   :show-inheritance:

docs/python_api/modules/common.rst

@@ -1,7 +1,7 @@
-dartpy.common
-=============
+dartpy
+======
 
-.. automodule:: dartpy.common
+.. note:: Legacy submodules will be removed in DART 8.0; use top-level `dartpy`.
+
+.. automodule:: dartpy
    :members:
-   :undoc-members:
-   :show-inheritance:

docs/python_api/modules/constraint.rst

@@ -1,7 +1,7 @@
-dartpy.constraint
-=================
+dartpy
+======
 
-.. automodule:: dartpy.constraint
+.. note:: Legacy submodules will be removed in DART 8.0; use top-level `dartpy`.
+
+.. automodule:: dartpy
    :members:
-   :undoc-members:
-   :show-inheritance:

docs/python_api/modules/dynamics.rst

@@ -1,7 +1,7 @@
-dartpy.dynamics
-===============
+dartpy
+======
 
-.. automodule:: dartpy.dynamics
+.. note:: Legacy submodules will be removed in DART 8.0; use top-level `dartpy`.
+
+.. automodule:: dartpy
    :members:
-   :undoc-members:
-   :show-inheritance:

docs/python_api/modules/gui.rst

@@ -3,5 +3,3 @@ dartpy.gui
 
 .. automodule:: dartpy.gui
    :members:
-   :undoc-members:
-   :show-inheritance:

docs/python_api/modules/math.rst

@@ -1,7 +1,7 @@
-dartpy.math
-============
+dartpy
+======
 
-.. automodule:: dartpy.math
+.. note:: Legacy submodules will be removed in DART 8.0; use top-level `dartpy`.
+
+.. automodule:: dartpy
    :members:
-   :undoc-members:
-   :show-inheritance:

docs/python_api/modules/optimizer.rst

@@ -1,7 +1,7 @@
-dartpy.optimizer
-================
+dartpy
+======
 
-.. automodule:: dartpy.optimizer
+.. note:: Legacy submodules will be removed in DART 8.0; use top-level `dartpy`.
+
+.. automodule:: dartpy
    :members:
-   :undoc-members:
-   :show-inheritance:

docs/python_api/modules/simulation.rst

@@ -1,7 +1,7 @@
-dartpy.simulation
-=================
+dartpy
+======
 
-.. automodule:: dartpy.simulation
+.. note:: Legacy submodules will be removed in DART 8.0; use top-level `dartpy`.
+
+.. automodule:: dartpy
    :members:
-   :undoc-members:
-   :show-inheritance:

docs/python_api/modules/utils.rst

@@ -1,7 +1,7 @@
-dartpy.utils
-============
+dartpy.io
+=========
 
-.. automodule:: dartpy.utils
+.. note:: Legacy `dartpy.utils` will be removed in DART 8.0; use `dartpy.io`.
+
+.. automodule:: dartpy.io
    :members:
-   :undoc-members:
-   :show-inheritance: