ENH: Add flake8-rst-docstrings to our flake8 plugin collection

Enables checking of formatting of docstrings.

environment.yml

@@ -30,6 +30,7 @@ dependencies:
   - flake8-pep3101
   - flake8-print
   - flake8-quotes
+  - flake8-rst-docstrings
   - pep8-naming
   - pyproj
   - cartopy

setup.cfg

@@ -3,7 +3,7 @@ ignore = W503
 max-line-length = 95
 
 [flake8]
-ignore = F405 D999 W503
+ignore = F405 D999 W503 RST306 RST902
 max-line-length = 95
 exclude = metpy/_version.py
 application-import-names = metpy
@@ -12,18 +12,22 @@ copyright-check = True
 copyright-author = MetPy Developers
 inline-quotes = single
 multiline-quotes = double
+rst-roles = class, data, func, meth, mod
+rst-directives = plot
 
 [tool:pytest]
 # https://github.com/matplotlib/pytest-mpl/issues/69
 markers = mpl_image_compare
 norecursedirs = build docs .idea
-flake8-ignore = *.py F405 W503
+flake8-ignore = *.py F405 W503 RST902
                 examples/*.py D T003 T001
                 tutorials/*.py D T003 T001
                 versioneer.py ALL
                 deprecation.py C801
                 metpy/calc/__init__.py D999
+                metpy/calc/*.py RST306
                 metpy/interpolate/__init__.py D999
+                metpy/interpolate/*.py RST306
                 metpy/io/__init__.py D999
                 metpy/plots/__init__.py D999
 flake8-max-line-length = 95

setup.py

@@ -63,7 +63,7 @@
                  'cartopy>=0.16.0', 'flake8>3.2.0', 'flake8-builtins!=1.4.0',
                  'flake8-comprehensions', 'flake8-copyright',
                  'flake8-docstrings', 'flake8-import-order', 'flake8-mutable',
-                 'flake8-pep3101', 'flake8-print', 'flake8-quotes',
+                 'flake8-pep3101', 'flake8-print', 'flake8-quotes', 'flake8-rst-docstrings',
                  'pep8-naming', 'netCDF4', 'pyproj>=1.9.4,!=2.0.0']
     },