Update deprecation docs to avoid duplicate autosummary/errors

Removes the duplicate deprecation autosummary docs to avoid errors from
logging output in the docs output strings.

Author: jsiirola

doc/OnlineDocs/explanation/developer_utils/deprecation.rst

@@ -9,40 +9,29 @@ Deprecation
 -----------
 
 We offer a set of tools to help with deprecation in
-``pyomo.common.deprecation``.
+:py:mod:`pyomo.common.deprecation`.
 
 By policy, when deprecating or moving an existing capability, one of the
 following utilities should be leveraged.  Each has a required
 ``version`` argument that should be set to current development version (e.g.,
 ``"6.6.2.dev0"``).  This version will be updated to the next actual
 release as part of the Pyomo release process.  The current development version
-can be found by running ``pyomo --version`` on your local fork/branch.
+can be found by running
+
+   ``pyomo --version``
+
+on your local fork/branch.
 
 .. currentmodule:: pyomo.common.deprecation
 
 .. autosummary::
 
    deprecated
    deprecation_warning
-   relocated_module
+   moved_module
    relocated_module_attribute
    RenamedClass
 
-.. autodecorator:: pyomo.common.deprecation.deprecated
-   :noindex:
-
-.. autofunction:: pyomo.common.deprecation.deprecation_warning
-   :noindex:
-
-.. autofunction:: pyomo.common.deprecation.relocated_module
-   :noindex:
-
-.. autofunction:: pyomo.common.deprecation.relocated_module_attribute
-   :noindex:
-
-.. autoclass:: pyomo.common.deprecation.RenamedClass
-   :noindex:
-
 
 Removal
 -------
@@ -52,10 +41,8 @@ warning, pending extenuating circumstances. The functionality should
 be deprecated, following the information above.
 
 If the functionality is documented in the most recent
-edition of [`Pyomo - Optimization Modeling in Python`_], it may not be removed
-until the next major version release.
-
-.. _Pyomo - Optimization Modeling in Python: https://doi.org/10.1007/978-3-030-68928-5
+edition of :ref:`Pyomo - Optimization Modeling in Python <pyomobookiii>`,
+it may not be removed until the next major version release.
 
 For other functionality, it is preferred that ample time is given
 before removing the functionality. At minimum, significant functionality

doc/OnlineDocs/reference/bibliography.rst

@@ -29,6 +29,10 @@ These publications describe various Pyomo capabilitites or subpackages:
    Vol. 67. Springer. 2021.  DOI `10.1007/978-3-030-68928-5
    <https://doi.org/10.1007/978-3-030-68928-5>`_
 
+..
+   NOTE: When adding a new edition of the Pyomo Book, search the codebase
+   both for citation references "[PyomoBookIII]" and references "pyomobookiii"
+
 .. [PyomoDAE-paper] Bethany Nicholson, John D. Siirola, Jean-Paul Watson,
    Victor M. Zavala, and Lorenz T. Biegler. "pyomo.dae: a modeling and
    automatic discretization framework for optimization with differential

pyomo/common/deprecation.py

@@ -169,7 +169,7 @@ def _find_calling_frame(module_offset):
 def deprecation_warning(
     msg, logger=None, version=None, remove_in=None, calling_frame=None
 ):
-    """Standardized formatter for deprecation warnings
+    """Standardized function for formatting and emitting deprecation warnings.
 
     This is a standardized routine for formatting deprecation warnings
     so that things look consistent and "nice".