De-duplicated mplot3D API docs

dstansby · dstansby · commit 60de50272258 · 2022-01-01T22:29:00.000Z
diff --git a/doc/api/next_api_changes/behavior/21026-DS.rst b/doc/api/next_api_changes/behavior/21026-DS.rst
@@ -1,5 +1,5 @@
 3D contourf polygons placed between levels
 ------------------------------------------
-The polygons used in a 3D `~mpl_toolkits.mplot3d.Axes3D.contourf` plot are
+The polygons used in a 3D `~.Axes3D.contourf` plot are
 now placed halfway between the contour levels, as each polygon represents the
 location of values that lie between two levels.
diff --git a/doc/api/prev_api_changes/api_changes_3.5.0/behaviour.rst b/doc/api/prev_api_changes/api_changes_3.5.0/behaviour.rst
@@ -235,7 +235,7 @@ yet parsed, but this is a prerequisite for implementing subsetting.
 3D contourf polygons placed between levels
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The polygons used in a 3D `~mpl_toolkits.mplot3d.Axes3D.contourf` plot are now
+The polygons used in a 3D `~.Axes3D.contourf` plot are now
 placed halfway between the contour levels, as each polygon represents the
 location of values that lie between two levels.
 
diff --git a/doc/users/prev_whats_new/whats_new_1.4.rst b/doc/users/prev_whats_new/whats_new_1.4.rst
@@ -242,7 +242,7 @@ Simple quiver plot for mplot3d toolkit
 A team of students in an *Engineering Large Software Systems* course, taught
 by Prof. Anya Tafliovich at the University of Toronto, implemented a simple
 version of a quiver plot in 3D space for the mplot3d toolkit as one of their
-term project. This feature is documented in :func:`~mpl_toolkits.mplot3d.Axes3D.quiver`.
+term project. This feature is documented in `~.Axes3D.quiver`.
 The team members are: Ryan Steve D'Souza, Victor B, xbtsw, Yang Wang, David,
 Caradec Bisesar and Vlad Vassilovski.
 
diff --git a/doc/users/prev_whats_new/whats_new_1.5.rst b/doc/users/prev_whats_new/whats_new_1.5.rst
@@ -340,7 +340,7 @@ Added a :mod:`.legend_handler` for :class:`~matplotlib.collections.PolyCollectio
 Support for alternate pivots in mplot3d quiver plot
 ```````````````````````````````````````````````````
 
-Added a :code:`pivot` kwarg to :func:`~mpl_toolkits.mplot3d.Axes3D.quiver`
+Added a :code:`pivot` kwarg to `~.Axes3D.quiver`
 that controls the pivot point around which the quiver line rotates. This also
 determines the placement of the arrow head along the quiver line.
 
diff --git a/tutorials/toolkits/mplot3d.py b/tutorials/toolkits/mplot3d.py
@@ -5,7 +5,8 @@
 
 Generating 3D plots using the mplot3d toolkit.
 
-.. currentmodule:: mpl_toolkits.mplot3d
+This tutorial showcases various 3D plots. Click on the figures to see each full
+gallery example with the code that generates the figures.
 
 .. contents::
    :backlinks: none
@@ -39,79 +40,72 @@
 
 Line plots
 ==========
+See `.Axes3D.plot` for API documentation.
 
 .. figure:: ../../gallery/mplot3d/images/sphx_glr_lines3d_001.png
    :target: ../../gallery/mplot3d/lines3d.html
    :align: center
 
-.. automethod:: Axes3D.plot
-
 .. _scatter3d:
 
 Scatter plots
 =============
+See `.Axes3D.scatter` for API documentation.
 
 .. figure:: ../../gallery/mplot3d/images/sphx_glr_scatter3d_001.png
    :target: ../../gallery/mplot3d/scatter3d.html
    :align: center
 
-.. automethod:: Axes3D.scatter
-
 .. _wireframe:
 
 Wireframe plots
 ===============
+See `.Axes3D.plot_wireframe` for API documentation.
 
 .. figure:: ../../gallery/mplot3d/images/sphx_glr_wire3d_001.png
    :target: ../../gallery/mplot3d/wire3d.html
    :align: center
 
-.. automethod:: Axes3D.plot_wireframe
-
 .. _surface:
 
 Surface plots
 =============
+See `.Axes3D.plot_surface` for API documentation.
 
 .. figure:: ../../gallery/mplot3d/images/sphx_glr_surface3d_001.png
    :target: ../../gallery/mplot3d/surface3d.html
    :align: center
 
-.. automethod:: Axes3D.plot_surface
-
 .. _trisurface:
 
 Tri-Surface plots
 =================
+See `.Axes3D.plot_trisurf` for API documentation.
 
 .. figure:: ../../gallery/mplot3d/images/sphx_glr_trisurf3d_001.png
    :target: ../../gallery/mplot3d/trisurf3d.html
    :align: center
 
-.. automethod:: Axes3D.plot_trisurf
-
 .. _contour3d:
 
 Contour plots
 =============
+See `.Axes3D.contour` for API documentation.
 
 .. figure:: ../../gallery/mplot3d/images/sphx_glr_contour3d_001.png
    :target: ../../gallery/mplot3d/contour3d.html
    :align: center
 
-.. automethod:: Axes3D.contour
-
 .. _contourf3d:
 
 Filled contour plots
 ====================
+See `.Axes3D.contourf` for API documentation.
 
 .. figure:: ../../gallery/mplot3d/images/sphx_glr_contourf3d_001.png
    :target: ../../gallery/mplot3d/contourf3d.html
    :align: center
 
-.. automethod:: Axes3D.contourf
-
 .. versionadded:: 1.1.0
    The feature demoed in the second contourf3d example was enabled as a
    result of a bugfix for version 1.1.0.
@@ -120,35 +114,32 @@
 
 Polygon plots
 =============
+See `.Axes3D.add_collection3d` for API documentation.
 
 .. figure:: ../../gallery/mplot3d/images/sphx_glr_polys3d_001.png
    :target: ../../gallery/mplot3d/polys3d.html
    :align: center
 
-.. automethod:: Axes3D.add_collection3d
-
 .. _bar3d:
 
 Bar plots
 =========
+See `.Axes3D.bar` for API documentation.
 
 .. figure:: ../../gallery/mplot3d/images/sphx_glr_bars3d_001.png
    :target: ../../gallery/mplot3d/bars3d.html
    :align: center
 
-.. automethod:: Axes3D.bar
-
 .. _quiver3d:
 
 Quiver
 ======
+See `.Axes3D.quiver` for API documentation.
 
 .. figure:: ../../gallery/mplot3d/images/sphx_glr_quiver3d_001.png
    :target: ../../gallery/mplot3d/quiver3d.html
    :align: center
 
-.. automethod:: Axes3D.quiver
-
 .. _2dcollections3d:
 
 2D plots in 3D
@@ -161,10 +152,9 @@
 
 Text
 ====
+See `.Axes3D.text` for API documentation.
 
 .. figure:: ../../gallery/mplot3d/images/sphx_glr_text3d_001.png
    :target: ../../gallery/mplot3d/text3d.html
    :align: center
-
-.. automethod:: Axes3D.text
 """
