Update docstring formatting and mkdocs config

Author: sol1105

docs/LICENSE

@@ -0,0 +1 @@
+../LICENSE

esgf_qa/cluster_results.py

@@ -14,12 +14,6 @@ class QAResultAggregator:
     and files, normalizes them into a consistent internal summary structure, and provides
     functionality to sort, cluster, and generalize similar messages.
 
-    Parameters
-    ----------
-    checker_dict : dict
-        Dictionary mapping checker names (e.g., ``"cf"``) to human-readable labels.
-        Used to label tests and messages in the summary.
-
     Attributes
     ----------
     summary : dict of defaultdict
@@ -33,7 +27,10 @@ class QAResultAggregator:
         messages are generalized and aggregated/clustered across similar text patterns.
     checker_dict : dict
         Mapping of checker identifiers to human-readable names, used
-        for consistent labeling in summaries.
+        for consistent labeling in summaries. Only cc checks.
+    checker_dict_ext : dict
+        Mapping of checker identifiers to human-readable names, used
+        for consistent labeling in summaries. cc checks extended by esgf_qa checks.
 
     Methods
     -------

esgf_qa/con_checks.py

@@ -155,6 +155,7 @@ def consistency_checks(ds, ds_map, files_to_check_dict, checker_options):
     Consistency checks.
 
     Runs inter-file consistency checks on a dataset:
+
         - Global attributes (values and data types)
         - Variable attributes (values and data types)
         - Coordinates (values)
@@ -443,6 +444,7 @@ def compatibility_checks(ds, ds_map, files_to_check_dict, checker_options):
     Compatibility checks for a dataset.
 
     Checks for:
+
         - xarray open_mfdataset (compat='override', join='outer')
         - xarray open_mfdataset (compat='no_conflicts', join='exact')
 
@@ -607,6 +609,7 @@ def inter_dataset_consistency_checks(ds_map, files_to_check_dict, checker_option
 
     Will group datasets by realm and grid for certain checks.
     Runs inter-dataset consistency checks:
+
         - Required and non-required global attributes (values and data types)
         - Coordinates (values)
         - Dimensions (names and sizes)

mkdocs.yml

@@ -26,4 +26,5 @@ plugins:
             docstring_style: numpy
             show_source: true
             show_signature: true
-
+            extra:
+              rendering_style: markdown