Apply suggestions from code review

timhoffm · jklymak · web-flow · commit cc2f863d4136 · 2022-12-17T01:14:13.000+01:00
Co-authored-by: Jody Klymak &lt;jklymak@gmail.com&gt;
diff --git a/doc/api/next_api_changes/deprecations/24730-TH.rst b/doc/api/next_api_changes/deprecations/24730-TH.rst
@@ -5,20 +5,18 @@ Relying on ``rcParams`` being a ``dict`` subclass is deprecated.
 Nothing will change for regular users because ``rcParams`` will continue to
 be dict-like (technically fulfill the ``MutableMapping`` interface).
 
-However, there are some rare known cases that use
-``dict.__getitem__(rcParams, key)`` and
-``dict.__setitem__(rcParams, key, val)`` for direct data access that
-circumvents any validation logic. While this is technically public, it
-depends on the implementation detail that ``rcParams`` is currently a ``dict``
-subclass.
+The `.RcParams` class does validation checking on calls to `.RcParams.__get_item__` and 
+`.RcParams.__set_item__`.  However, there are rare cases where we want to circumvents the 
+validation logic and directly access the underlying data values.   Previously, this could be 
+accomplished via  a call to the parent methods  ``dict.__getitem__(rcParams, key)`` and ``dict.__setitem__(rcParams, key, val)``. 
 
 Matplotlib 3.7 introduces ``rcParams._set(key, val)`` and
-``rcParams._get(key)`` as a replacements for these cases. They are
-intentionally marked private because there is very little need for external
-users to use them. However, if you have a compelling reason for direct data
+``rcParams._get(key)`` as a replacement to calling the parent methods. They are
+intentionally marked private because there is little need for external
+users to use them. However, if you have a compelling reason for direct `.RcParam` data
 access, please switch from the dict functions to the new ``_get()`` and
 ``_set()``. Even though marked private, we guarantee API stability for these
-methods, i.e., they are subject to Matplotlib's API and deprecation policy.
+methods and they are subject to Matplotlib's API and deprecation policy.
 
 Please notify the Matplotlib developers if you rely on ``rcParams`` being a
 dict subclass in any other way, for which there is no migration path yet.
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
@@ -200,7 +200,7 @@ def _get_backend_mod():
     This is currently private, but may be made public in the future.
     """
     if _backend_mod is None:
-        # Use rcParams.get("backend") to avoid going through the fallback
+        # Use rcParams._get("backend") to avoid going through the fallback
         # logic (which will (re)import pyplot and then call switch_backend if
         # we need to resolve the auto sentinel)
         switch_backend(rcParams._get("backend"))
