clarify card.usage.* apis only track cell/wifi (#253)

Author: rdlauer

card.usage.get.req.notecard.api.json

@@ -2,7 +2,7 @@
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://raw.githubusercontent.com/blues/notecard-schema/master/card.usage.get.req.notecard.api.json",
     "title": "card.usage.get Request Application Programming Interface (API) Schema",
-    "description": "Returns the card's network usage statistics.",
+    "description": "Returns the Notecard's network usage statistics for cellular and Wi-Fi transmissions.",
     "type": "object",
     "version": "1.1.2",
     "apiVersion": "9.1.1",
@@ -80,13 +80,13 @@
     "annotations": [
         {
             "title": "note",
-            "description": "Usage data is updated by the Notecard at the end of each network connection. If connected in `continuous` mode, usage data will not be updated until the current session ends, which you can [configure with the `hub.set` `duration` argument](https://dev.blues.io/api-reference/notecard-api/hub-requests/#hub-set)."
+            "description": "Usage data is updated by the Notecard at the end of each session. If connected in `continuous` mode, usage data will not be updated until the current session ends, which you can [configure with the `hub.set` `duration` argument](https://dev.blues.io/api-reference/notecard-api/hub-requests/#hub-set).\n\nPlease note that the `card.usage.get` API only applies to cellular and Wi-Fi data, not LoRa or satellite (NTN)."
         }
     ],
     "samples": [
         {
             "title": "Get Total Usage",
-            "description": "Retrieve all usage statistics since Notecard activation.",
+            "description": "Retrieve all cellular and Wi-Fi usage statistics since Notecard activation.",
             "json": "{\"req\": \"card.usage.get\"}"
         },
         {

card.usage.get.rsp.notecard.api.json

@@ -2,7 +2,7 @@
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://raw.githubusercontent.com/blues/notecard-schema/master/card.usage.get.rsp.notecard.api.json",
     "title": "card.usage.get Response Application Programming Interface (API) Schema",
-    "description": "Response containing network usage statistics for the specified time period.",
+    "description": "Response containing cellular and Wi-Fi network usage statistics for the specified time period.",
     "type": "object",
     "version": "1.1.2",
     "apiVersion": "9.1.1",
@@ -49,12 +49,12 @@
     "samples": [
         {
             "title": "Complete Usage Statistics",
-            "description": "Example response showing comprehensive network usage data.",
+            "description": "Example response showing comprehensive cellular and Wi-Fi network usage data.",
             "json": "{\"seconds\":1291377, \"time\":1598479763, \"bytes_sent\":163577, \"bytes_received\":454565, \"notes_sent\":114, \"notes_received\":26, \"sessions_standard\":143, \"sessions_secure\":31}"
         },
         {
             "title": "Partial Usage Statistics",
-            "description": "Example response with basic usage metrics.",
+            "description": "Example response with basic cellular and Wi-Fi usage metrics.",
             "json": "{\"seconds\":3600, \"time\":1700000000, \"bytes_sent\":1024, \"bytes_received\":2048}"
         }
     ]

card.usage.test.req.notecard.api.json

@@ -2,7 +2,7 @@
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://raw.githubusercontent.com/blues/notecard-schema/master/card.usage.test.req.notecard.api.json",
     "title": "card.usage.test Request Application Programming Interface (API) Schema",
-    "description": "Calculates a projection of how long the available data quota will last based on the observed usage patterns.",
+    "description": "Calculates a projection of how long the available cellular data quota will last based on the observed usage patterns.",
     "type": "object",
     "version": "1.1.2",
     "apiVersion": "9.1.1",
@@ -21,7 +21,7 @@
             "type": "integer"
         },
         "megabytes": {
-            "description": "The Notecard lifetime data quota (in megabytes) to use for the test.",
+            "description": "The Notecard lifetime cellular data quota (in megabytes) to use for the test.",
             "type": "integer",
             "default": 1024
         },
@@ -57,6 +57,12 @@
         }
     ],
     "additionalProperties": false,
+    "annotations": [
+        {
+            "title": "note",
+            "description": "The `card.usage.test` API only applies to cellular and Wi-Fi data, not LoRa or satellite (NTN)."
+        }
+    ],
     "samples": [
         {
             "title": "Test 7-Day Usage Projection",

card.usage.test.rsp.notecard.api.json

@@ -2,7 +2,7 @@
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://raw.githubusercontent.com/blues/notecard-schema/master/card.usage.test.rsp.notecard.api.json",
     "title": "card.usage.test Response Application Programming Interface (API) Schema",
-    "description": "Response containing data usage projection and analysis results.",
+    "description": "Response containing cellular data usage projection and analysis results.",
     "type": "object",
     "version": "1.1.2",
     "apiVersion": "9.1.1",