diff --git a/cfelpyutils/__init__.py b/cfelpyutils/__init__.py
index a6eda16daada1429d9f822def59bf522607e2b76..e7ed0c0ad24460cd69ad8d5522b3e3be4cbd718f 100644
--- a/cfelpyutils/__init__.py
+++ b/cfelpyutils/__init__.py
@@ -20,13 +20,13 @@ and classes used by many projects developed at the Center For Free
 Electron Laser Science (CFEL) in Hamburg.
 (`Link CFEL: https://www.cfel.de`)
 
-The 'crystfel_utils' submodule contains python implementations of
+The 'crystfel_utils' submodule contains the python implementation of
 some functions from the CrystFEL software package.
 (`Link CrystFEL http://www.desy.de/~twhite/crystfel/`)
 
 The 'geometry_utils' submodule contains the implementation of functions
 used to manipulate detector geometry information.
 
-The 'parameter utils' submodule contains the implementation of
-functions used to manipulate detector geometry information.
+This 'parameter_utils' module contains the implementation of functions
+that are used to parse and manipulate options and parameters.
 """
diff --git a/cfelpyutils/crystfel_utils.py b/cfelpyutils/crystfel_utils.py
index 63566103b3082637e756d089abe04b358453c5a2..c218c42b28ffd221882d793d4b2f20fb4b56764e 100644
--- a/cfelpyutils/crystfel_utils.py
+++ b/cfelpyutils/crystfel_utils.py
@@ -15,8 +15,9 @@
 """
 CryystFEL utilities.
 
-This module contains the implementation of several functions used to
-interact with CrystFEL files and data (geometry files, stream files).
+This module contains the python implementation of some functions from
+the CrystFEL software package.
+(`Link CrystFEL http://www.desy.de/~twhite/crystfel/`)
 """
 from __future__ import (absolute_import, division, print_function,
                         unicode_literals)
diff --git a/cfelpyutils/geometry_utils.py b/cfelpyutils/geometry_utils.py
index c280f73154e9438c071e33ba66683b0044c7c319..dd44cdeedae3e61dcac36b50ea5670fb744f6010 100644
--- a/cfelpyutils/geometry_utils.py
+++ b/cfelpyutils/geometry_utils.py
@@ -16,7 +16,8 @@
 Geometry utilities.
 
 This module contains the implementation of several functions used to
-manipulate geometry information."""
+manipulate geometry information.
+"""
 from __future__ import (absolute_import, division, print_function,
                         unicode_literals)
 
@@ -173,7 +174,7 @@ def compute_visualization_pix_maps(geometry):
 
     Args:
 
-        geometry (dict): A CrystFEL geometry object (A dictionary
+        geometry (Dict): A CrystFEL geometry object (A dictionary
             returned by the
             :obj:`cfelpyutils.crystfel_utils.load_crystfel_geometry`
             function).
diff --git a/cfelpyutils/parameter_utils.py b/cfelpyutils/parameter_utils.py
index dd5a0392320be2fb50f69e2e4b788e19bcb5347c..5ce1481b8f02fa1cb683cdd726e786f695cc1587 100644
--- a/cfelpyutils/parameter_utils.py
+++ b/cfelpyutils/parameter_utils.py
@@ -15,8 +15,9 @@
 """
 Parameter parsing utilities.
 
-This module contains the implementation of several utilities used
-to parse and manipulate dictionaries that store options and parameters.
+This 'parameter_utils' module contains the implementation of functions
+that are used to parse and manipulate options and parameters, as
+extracted by the python :obj:`configparse` module.
 """
 from __future__ import (absolute_import, division, print_function,
                         unicode_literals)
@@ -38,9 +39,9 @@ def convert_parameters(config_dict):
     """
     Convert strings in parameter dictionaries to the correct data type.
 
-    Convert a dictionary return by the configparse module to a
-    dictionar contaning the same parameters converted from string to
-    their correct type (int, float, string, etc.)
+    Convert a dictionary extracted by the configparse module to a
+    dictionary contaning the same parameters converted from strings to
+    correct types (int, float, string, etc.)
 
     Try to convert each entry in the dictionary according to the
     following rules. The first rule that applies to the entry
@@ -69,8 +70,9 @@ def convert_parameters(config_dict):
 
     Args:
 
-        config (Dict): a dictionary containing strings (the dictionary
-            returned by Config Parser).
+        config (Dict[str]): a dictionary containing the parameters from
+            a configuration file as extracted by the
+            :obj:`configparser` module).
 
     Returns: