docs: Clarify CLI help text to align with databus hierarchy

databusclient/api/deploy.py

@@ -268,9 +268,9 @@
 
 def create_dataset(
     version_id: str,
-    title: str,
-    abstract: str,
-    description: str,
+    artifact_title: str,
+    artifact_abstract: str,
+    artifact_description: str,
     license_url: str,
     distributions: List[str],
     attribution: str = None,
@@ -422,9 +422,9 @@
     log_level: DeployLogLevel = DeployLogLevel.debug,
     debug: bool = False,
 ) -> None:
     """Deploys a dataset to the databus. The endpoint is inferred from the DataID identifier.
     Parameters
     ----------
     dataid: Dict[str, Union[List[Dict[str, Union[bool, str, int, float, List]]], str]]
         The dataid represented as a python dict. Preferably created by the creaateDataset function
     api_key: str
@@ -434,9 +434,9 @@
     log_level: DeployLogLevel
         log level of the deploy output
     debug: bool
         controls whether output shold be printed to the console (stdout)
     """
 
     headers = {"X-API-KEY": f"{api_key}", "Content-Type": "application/json"}
     data = json.dumps(dataid)
 

databusclient/cli.py

@@ -25,9 +25,9 @@ def app():
     help="Target databus version/dataset identifier of the form "
     "<https://databus.dbpedia.org/$ACCOUNT/$GROUP/$ARTIFACT/$VERSION>",
 )
-@click.option("--title", required=True, help="Dataset title")
-@click.option("--abstract", required=True, help="Dataset abstract max 200 chars")
-@click.option("--description", required=True, help="Dataset description")
+@click.option("--title", required=True, help="Artifact title: the permanent name of the data series (applies to all versions)")
+@click.option("--abstract", required=True, help="Version Abstract: a short summary (max 200 chars) specific to this timestamped release")
+@click.option("--description", required=True, help="Version Description: detailed metadata for this specific release (supports Markdown)")
 @click.option(
     "--license", "license_url", required=True, help="License (see dalicc.net)"
 )