Give Warning on prefix pandas

Author: thoo

scripts/tests/test_validate_docstrings.py

@@ -334,6 +334,14 @@ def method(self, foo=None, bar=None):
         pass
 
 
+class BadSeeAlso(object):
+
+    def prefix_pandas(self):
+        """
+        Return  prefix with `pandas` from See Also sec
+        """
+        pass
+
 class BadSummaries(object):
 
     def wrong_line(self):
@@ -608,6 +616,9 @@ def test_bad_generic_functions(self, func):
         assert errors
 
     @pytest.mark.parametrize("klass,func,msgs", [
+        #SeeAlso tests
+        ('BadSeeAlso', 'prefix_pandas',
+         ('Should not start with pandas',)),
         # Summary tests
         ('BadSummaries', 'wrong_line',
          ('should start in the line immediately after the opening quotes',)),

scripts/validate_docstrings.py

@@ -508,7 +508,8 @@ def validate_one(func_name):
             if not rel_desc:
                 errs.append('Missing description for '
                             'See Also "{}" reference'.format(rel_name))
-
+            if rel_name[:7].lower() == 'pandas.':
+                errs.append('{} should not have prefix `pandas`'.format(rel_name))
     for line in doc.raw_doc.splitlines():
         if re.match("^ *\t", line):
             errs.append('Tabs found at the start of line "{}", '