Minor doc tweaks + updated package-lock.json

Author: motin

docs/development-on-the-utils.md

@@ -275,3 +275,8 @@ circleci build
 ```
 
 Note: Steps related to caching and uploading/storing artifacts will report as failed locally. This is not necessarily a problem, they are designed to fail since the operations are not supported locally by the CircleCI build agent.
+
+# NPM release routine
+
+npx publish-please --dry-run
+npx publish-please

package-lock.json

@@ -149,16 +149,11 @@ Object of current dataPermissions (shield enabled true/false, pioneer enabled tr
 
 Send Telemetry using appropriate shield or pioneer methods.
 
-shield & pioneer sends using the following schema:
-
-* `shield-study-addon` ping, requires object string keys and string values
+Note: The payload must adhere to the `data.attributes` property in the [`shield-study-addon`](https://github.com/mozilla-services/mozilla-pipeline-schemas/blob/dev/templates/include/telemetry/shieldStudyAddonPayload.3.schema.json) schema. That is, it must be a flat object with string keys and string values.
 
 Note:
 
 * no conversions / coercion of data happens.
-
-Note:
-
 * undefined what happens if validation fails
 
 TBD fix the parameters here.

webExtensionApis/study/api.md

@@ -656,7 +656,7 @@
         "name": "sendTelemetry",
         "type": "function",
         "description":
-          "Send Telemetry using appropriate shield or pioneer methods.\n\nshield & pioneer sends using the following schema:\n- `shield-study-addon` ping, requires object string keys and string values\n\nNote:\n- no conversions / coercion of data happens.\n\nNote:\n- undefined what happens if validation fails\n\nTBD fix the parameters here.\n",
+          "Send Telemetry using appropriate shield or pioneer methods.\n\nNote: The payload must adhere to the `data.attributes` property in the [`shield-study-addon`](https://github.com/mozilla-services/mozilla-pipeline-schemas/blob/dev/templates/include/telemetry/shieldStudyAddonPayload.3.schema.json) schema. That is, it must be a flat object with string keys and string values.\n\nNote:\n- no conversions / coercion of data happens.\n- undefined what happens if validation fails\n\nTBD fix the parameters here.\n",
         "async": true,
         "parameters": [
           {