diff --git a/brian_polling_manager/cli.py b/brian_polling_manager/cli.py
index a3a19129bac3148062e0ef9e7369bd40c02b3443..b2cc6102d1647f0e476b384a91bc556bee8f2dff 100644
--- a/brian_polling_manager/cli.py
+++ b/brian_polling_manager/cli.py
@@ -1,3 +1,28 @@
+"""
+This script queries Inventory Provider for changes
+and configures Sensu with the snmp polling checks
+required by BRIAN.
+
+.. code-block:: console
+
+    % python brian_polling_manager/cli.py --help
+    Usage: cli.py [OPTIONS]
+
+      Update BRIAN snmp checks based on Inventory Provider data.
+
+    Options:
+      --config TEXT         configuration filename
+      --force / --no-force  update even if inventory hasn't been updated
+      --help                Show this message and exit.
+
+
+The required configuration file must be
+formatted according to the following schema:
+
+.. asjson::
+    brian_polling_manager.cli.CONFIG_SCHEMA
+
+"""
 import json
 import logging
 import os
@@ -194,6 +219,9 @@ def _validate_config(ctx, param, value):
     default=False,
     help="update even if inventory hasn't been updated")
 def main(config, force):
+    """
+    Update BRIAN snmp checks based on Inventory Provider data.
+    """
 
     state = State(config['statedir'])
     last = inventory.last_update_timestamp(config['inventory'])
diff --git a/docs/source/cli.rst b/docs/source/cli.rst
new file mode 100644
index 0000000000000000000000000000000000000000..0255ffa9daada3086ede5f35c2504d5d15e289d5
--- /dev/null
+++ b/docs/source/cli.rst
@@ -0,0 +1,6 @@
+
+cli
+===================================================
+
+.. automodule:: brian_polling_manager.cli
+
diff --git a/docs/source/index.rst b/docs/source/index.rst
index 474893bbdbc74aaf9b52856fa1642bb0ee555298..d87a4b83d0b48564ca2897eb4d64af5692b64444 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -3,18 +3,17 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to BRIAN Polling Manager's documentation!
-=================================================
 
-.. toctree::
-   :maxdepth: 2
-   :caption: Contents:
+BRIAN Polling Manager
+======================
 
+Documentation for BRIAN Polling Manager.
+This application queries Inventory Provider and configures
+Sensu checks for polling the data required by BRIAN.
 
 
-Indices and tables
-==================
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
 
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
+   cli