DOC: Updated documentation a bit.

src/linkahead/configuration.py

@@ -96,16 +96,18 @@ def validate_yaml_schema(valobj):
 
 
 def _read_config_files():
-    """Function to read config files from different paths.
+    """Read config files from different paths.
 
-    Checks for path either in ``$PYLINKAHEADINI`` or home directory (``.pylinkahead.ini``), and
-    additionally in the current working directory (``pylinkahead.ini``).
+    Read the config from either ``$PYLINKAHEADINI`` or home directory (``~/.pylinkahead.ini``), and
+    additionally adds config from a config file in the current working directory
+    (``pylinkahead.ini``).  All of these are optional.
 
     Returns
     -------
 
     ini files: list
-      The successfully parsed ini-files. Order: env_var or home directory, cwd. Used for testing the function.
+      The successfully parsed ini-files. Order: environment variable or home directory, then cwd.
+      Used for testing the function.
 
     """
     return_var = []