add description and source to quality dimensions

ohsome_quality_api/quality_dimensions/models.py

@@ -5,6 +5,7 @@
 class QualityDimension(BaseModel):
     name: str
     description: str
+    source: str | None = None
     model_config = ConfigDict(
         title="Topic",
         frozen=True,

ohsome_quality_api/quality_dimensions/quality_dimensions.yaml

@@ -1,20 +1,24 @@
 ---
-# TODO description
 
 completeness:
   name: Completeness
   description: >-
-    something that is still a TODO
+    The degree to which subject data associated with an entity has values for all expected attributes
+    and related entity instances in a specific context of use.
+  source:
+    https://www.iso.org/standard/78900.html
 
 currentness:
   name: Currentness
   description: >-
-    something that is still a TODO
+    The degree to which data has attributes that are of the right age in a specific context of use.
+  source:
+    https://www.iso.org/standard/35736.html
 
 minimal:
   name: Minimal
   description: >-
-    something that is still a TODO
+    A minimal quality dimension definition for testing purposes.
 
 none:
   name: None

tests/integrationtests/api/conftest.py

@@ -85,9 +85,11 @@ def metadata_report_multilevel_mapping_saturation():
 @pytest.fixture
 def metadata_quality_dimension_completeness():
     return {
-        "completeness": {
-            "name": "Completeness",
-            "description": "something that is still a TODO",
+        "minimal": {
+            "name": "Minimal",
+            "description": "black A minimal quality dimension"
+            " definition for testing purposes.",
+            "source": None,
         }
     }
 

tests/integrationtests/api/test_metadata.py

@@ -23,8 +23,8 @@ def test_metadata(
     )
     # check quality dimensions result
     assert (
-        metadata_quality_dimension_completeness["completeness"]
-        == result["qualityDimensions"]["completeness"]
+        metadata_quality_dimension_completeness["minimal"]
+        == result["qualityDimensions"]["minimal"]
     )
     # check projects result
     assert metadata_project_core["core"] == result["projects"]["core"]