Zeroto521
diff --git a/‎.azure-pipelines/templates/run-tests.yml
+5-1 b/‎.azure-pipelines/templates/run-tests.yml
+5-1
diff --git a/‎.darglint
+4 b/‎.darglint
+4
diff --git a/‎.pre-commit-config.yaml
+7-2 b/‎.pre-commit-config.yaml
+7-2
diff --git a/‎CHANGELOG.rst
+13-2 b/‎CHANGELOG.rst
+13-2
diff --git a/‎janitor/chemistry.py
+4 b/‎janitor/chemistry.py
+4
diff --git a/‎janitor/engineering.py
+1 b/‎janitor/engineering.py
+1
diff --git a/‎janitor/finance.py
+2 b/‎janitor/finance.py
+2
@@ -10,7 +10,11 @@ steps:
   - script: |
       $(activate.command) pyjanitor-dev
       interrogate
-    displayName: 'Docstring coverage'
+    displayName: 'Docstring coverage: interrogate'
+  - script: |
+      $(activate.command) pyjanitor-dev
+      darglint janitor -v 2
+    displayName: 'Docstring linter: darglint'
   - script: |
       $(activate.command) pyjanitor-dev
       pytest
 
@@ -0,0 +1,4 @@
+[darglint]
+docstring_style=sphinx
+strictness=short
+ignore_regex=^(test_|_)(.*)
@@ -21,5 +21,10 @@ repos:
 - repo: https://github.com/econchick/interrogate
   rev: 1.1.5
   hooks:
-   - id: interrogate
-     args: [-c, pyproject.toml]
+  - id: interrogate
+    args: [-c, pyproject.toml]
+- repo: https://github.com/terrencepreilly/darglint
+  rev: master
+  hooks:
+  - id: darglint
+    args: [-v 2]  # this config makes the error messages a bit less cryptic.
@@ -1,22 +1,29 @@
 new version (on deck)
 =====================
+- [INF] Deploy ``darglint`` package for docstring linting. Issue #745. @loganthomas
+
+
+v0.20.10
+=======
 - [ENH] Added function ``sort_timestamps_monotonically`` to timeseries functions @UGuntupalli
 - [ENH] Added the complete function for converting implicit missing values
   to explicit ones. @samukweku
 - [ENH] Further simplification of expand_grid. @samukweku
 - [BUGFIX] Added copy() method to original dataframe, to avoid mutation. Issue #729. @samukweku
 - [ENH] Added `also` method for running functions in chain with no return values.
 - [DOC] Added a ``timeseries`` module section to website docs. Issue #742. @loganthomas
-- [ENH] Added a `pivot_longer` function, a wrapper around ``pd.melt`` and similar to 
+- [ENH] Added a `pivot_longer` function, a wrapper around ``pd.melt`` and similar to
   tidyr's ``pivot_longer`` function. Also added an example notebook. @samukweku
 - [ENH] Fixed code to returns error if `fill_value` is not a dictionary. @samukweku
 - [INF] Welcome bot (.github/config.yml) for new users added. Issue #739. @samukweku
 
+
 v0.20.9
 =======
 - [ENH] Updated groupby_agg function to account for null entries in the ``by`` argument. @samukweku
 - [ENH] Added function ``groupby_topk`` to janitor functions @mphirke
 
+
 v0.20.8
 =======
 - [ENH] Upgraded ``update_where`` function to use either the pandas query style,
@@ -38,7 +45,6 @@ v0.20.8
 - [ENH] Simpler logic and less lines of code for expand_grid function @samukweku
 
 
-
 v0.20.7
 =======
 - [TST] Add a test for transform_column to check for nonmutation. @VPerrollaz
@@ -61,11 +67,13 @@ v0.20.5
 - [ENH] ``select_columns()`` now raises ``NameError`` if column label in
   ``search_columns_labels`` is missing from ``DataFrame`` columns. @smu095
 
+
 v0.20.1
 =======
 - [DOC] Added an example for groupby_agg in general functions @samukweku
 - [ENH] Contributed ``sort_naturally()`` function. @ericmjl
 
+
 v0.20.0
 =======
 - [DOC] Edited transform_column dest_column_name kwarg description to be clearer on defaults by @evan-anderson.
@@ -76,6 +84,7 @@ v0.20.0
 - [ENH] Change ``find_replace`` implementation to use keyword arguments to specify columns to perform find and replace on. @ericmjl
 - [ENH] Add ``jitter()`` dataframe function by @rahosbach
 
+
 v0.19.0
 =======
 - [ENH] Add xarray support and clone_using / convert_datetime_to_number funcs by @zbarry.
@@ -96,6 +105,7 @@ v0.18.3
 - [DOC] Changed the typing for most "column_name(s)" to Hashable rather than enforcing strings, to more closely match Pandas API by @dendrondal
 - [INF] Edited pycodestyle and Black parameters to avoid venvs by @dendrondal
 
+
 v0.18.2
 =======
 - [INF] Make requirements.txt smaller @eyaltrabelsi
@@ -117,6 +127,7 @@ v0.18.2
 - [ENH] Add count_cumulative_unique() method to janitor.functions submodule by @rahosbach
 - [ENH] Add ``update_where()`` method to ``janitor.spark.functions`` submodule by @zjpoh
 
+
 v0.18.1
 =======
 - [ENH] extend find_replace functionality to allow both exact match and
 
@@ -134,6 +134,8 @@ def smiles2mol(
         constructed.
     :param progressbar: Whether to show a progressbar or not.
     :returns: A pandas DataFrame with new RDKIT Mol objects column.
+    :raises ValueError: if ``progressbar`` is not one of
+        ``"notebook"``, ``"terminal"``, or ``None``.
     """
     valid_progress = ["notebook", "terminal", None]
     if progressbar not in valid_progress:
@@ -247,6 +249,8 @@ def morgan_fingerprint(
     :param nbits: The length of the fingerprints. Defaults to 2048.
     :param kind: Whether to return counts or bits. Defaults to counts.
     :returns: A new pandas DataFrame of Morgan fingerprints.
+    :raises ValueError: if ``kind`` is not one of
+        ``"counts"`` or ``"bits"``.
     """
     acceptable_kinds = ["counts", "bits"]
     if kind not in acceptable_kinds:
 
@@ -87,6 +87,7 @@ def convert_units(
         converted values that will be created.
 
     :returns: A pandas DataFrame with a new column of unit-converted values.
+    :raises TypeError: if column is not numeric.
     """
 
     # Check all inputs are correct data type
 
@@ -433,6 +433,7 @@ def convert_currency(
         rates go back to Jan. 4, 1999.
     :param make_new_column: Generates new column for converted currency if
         True, otherwise, converts currency in place.
+    :returns: The dataframe with converted currency column.
 
     :Setup:
 
@@ -640,6 +641,7 @@ def inflate_currency(
         The year should be 1960 or later.
     :param make_new_column: Generates new column for inflated currency if
         True, otherwise, inflates currency in place.
+    :returns: The dataframe with inflated currency column.
     """
 
     inflator = _inflate_currency(country, currency_year, to_year)