Fix string prasing and test validator

Author: thoo

scripts/tests/test_validate_docstrings.py

@@ -549,6 +549,10 @@ class BadSeeAlso(object):
     def prefix_pandas(self):
         """
         Return  prefix with `pandas` from See Also sec
+
+        See Also
+        --------
+        pandas.Series.rename : Alter Series index labels or name
         """
         pass
 
@@ -665,7 +669,7 @@ def test_bad_generic_functions(self, func):
                      marks=pytest.mark.xfail),
         # SeeAlso tests
         ('BadSeeAlso', 'prefix_pandas',
-         ('Should not start with pandas',)),
+         ('section does not need the `pandas` prefix',)),
     ])
     def test_bad_examples(self, capsys, klass, func, msgs):
         result = validate_one(self._import_path(klass=klass, func=func))  # noqa:F821