[DOCS] add logo and authors to docs + docstrings for fetchers

docs/source/conf.py

@@ -11,7 +11,7 @@
 
 # General information about the project.
 project = 'glidertest'
-author = 'Callum Rollo'
+author = 'Eleanor Frajka-Williams, Chiara Monforte, Callum Rollo'
 copyright = f"{year}, {author}"
 release = 'v0.0.1'
 
@@ -39,3 +39,5 @@
 html_static_path = ['_static']
 
 source_suffix = [".rst", ".md"]
+
+html_logo = "_static/glider.png"

docs/source/glidertest.rst

@@ -4,4 +4,7 @@
 .. automodule:: glidertest.tools
    :members:
    :undoc-members:
-   :show-inheritance:
+
+.. automodule:: glidertest.fetchers
+   :members:
+   :undoc-members:

glidertest/fetchers.py

@@ -15,9 +15,20 @@
 
 
 def load_sample_dataset(dataset_name="sea076_20230906T0852_delayed.nc"):
+    """Download sample datasets for use with glidertest
+
+    Args:
+        dataset_name (str, optional): _description_. Defaults to "sea076_20230906T0852_delayed.nc".
+
+    Raises:
+        ValueError: If the requests dataset is not known, raises a value error
+
+    Returns:
+        xarray.Dataset: Requested sample dataset
+    """
     if dataset_name in data_source_og.registry.keys():
         file_path = data_source_og.fetch(dataset_name)
         return xr.open_dataset(file_path)
     else:
-        msg = f"Requested sample dataset {dataset_name} not known"
+        msg = f"Requested sample dataset {dataset_name} not known. Specify one of the following available datasets: {list(data_source_og.registry.keys())}"
         raise ValueError(msg)