Merge pull request #138 from mapbox/add-descriptions

update command descriptions

Author: Maria

CHANGELOG.md

@@ -2,6 +2,9 @@
 
 =======
 
+# 1.7.2 (2021-10-01)
+- Provide description for `upload-source` command, and label `add-source` command as deprecated.
+
 # 1.7.1 (2021-04-16)
 - Switch to codecov python module
 

mapbox_tilesets/__init__.py

@@ -1,3 +1,3 @@
 """mapbox_tilesets package"""
 
-__version__ = "1.7.1"
+__version__ = "1.7.2"

mapbox_tilesets/scripts/cli.py

@@ -524,6 +524,11 @@ def validate_source(features):
 def upload_source(
     ctx, username, id, features, no_validation, quiet, replace, token=None, indent=None
 ):
+    """Create a new tileset source, or add data to an existing tileset source.
+    Optionally, replace an existing tileset source.
+
+    tilesets upload-source <username> <source_id> <path/to/source/data>
+    """
     return _upload_source(
         ctx, username, id, features, no_validation, quiet, replace, token, indent
     )
@@ -532,10 +537,6 @@ def upload_source(
 def _upload_source(
     ctx, username, id, features, no_validation, quiet, replace, token=None, indent=None
 ):
-    """Create/add a tileset source
-
-    tilesets add-source <username> <source_id> <path/to/source/data>
-    """
     mapbox_api = utils._get_api()
     mapbox_token = utils._get_token(token)
     s = utils._get_session()
@@ -627,7 +628,7 @@ def callback(m):
 def add_source(
     ctx, username, id, features, no_validation, quiet, token=None, indent=None
 ):
-    """Create/add/replace a tileset source
+    """[DEPRECATED] Create/add/replace a tileset source. Use upload-source instead.
 
     tilesets add-source <username> <source_id> <path/to/source/data>
     """