DOC: Formatting and documentation fixup.

src/caosdb/configuration.py

@@ -90,15 +90,22 @@ def validate_yaml_schema(valobj):
         optional_jsonschema_validate(instance=valobj, schema=schema["schema-pycaosdb-ini"])
     else:
         warnings.warn("""
-                        Warning: The validation could not be performed because `jsonschema` is not installed.
-                    """)
+            Warning: The validation could not be performed because `jsonschema` is not installed.
+        """)
 
 
 def _read_config_files():
-    """Function to read config files from different paths. Checks for path in $PYCAOSDBINI or home directory (.pycaosdb.ini) and in the current working directory (pycaosdb.ini).
+    """Function to read config files from different paths.
+
+    Checks for path either in ``$PYCAOSDBINI`` or home directory (``.pycaosdb.ini``), and
+    additionally in the current working directory (``pycaosdb.ini``).
+
+    Returns
+    -------
+
+    ini files: list
+      The successfully parsed ini-files. Order: env_var or home directory, cwd. Used for testing the function.
 
-    Returns:
-        [list]: list with successfully parsed ini-files. Order: env_var or home directory, cwd. Used for testing the function.
     """
     return_var = []
     if "PYCAOSDBINI" in environ: