DOC: update comments and docstrings

tacaswell · timhoffm · web-flow · commit ff470cfb57ee · 2024-03-06T16:09:13.000-05:00
Co-authored-by: Tim Hoffmann &lt;2836374+timhoffm@users.noreply.github.com&gt;
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
@@ -8903,8 +8903,11 @@ def test_axhvlinespan_interpolation():
 @check_figures_equal(extensions=["png"])
 @pytest.mark.parametrize("which", ("x", "y"))
 def test_axes_clear_behavior(fig_ref, fig_test, which):
+    """Test that the given tick params are not reset by ax.clear()."""
     ax_test = fig_test.subplots()
     ax_ref = fig_ref.subplots()
+    # the following tick params values are chosen to each create a visual difference
+    # from their defaults 
     target = {
         "direction": "in",
         "length": 10,
