deprecate and replace old field, add description for survey id field

Author: akohlbre

schemas/pioneer-citp-news-disinfo/measurements/measurements.1.schema.json

@@ -142,7 +142,8 @@
                       "type": "string"
                     },
                     "classification": {
-                      "type": "integer"
+                      "description": "deprecated, use pageClassification",
+                      "type": "string"
                     },
                     "dayOfWeek": {
                       "type": "integer"
@@ -153,6 +154,9 @@
                     "numShares": {
                       "type": "integer"
                     },
+                    "pageClassification": {
+                      "type": "integer"
+                    },
                     "timeOfDay": {
                       "type": "integer"
                     },
@@ -173,6 +177,7 @@
       "type": "object"
     },
     "WebScience.SurveyId": {
+      "description": "ID sent to Qualtrics, for associating survey responses with telemetry data",
       "type": "string"
     }
   },

templates/pioneer-citp-news-disinfo/measurements/measurements.1.schema.json

@@ -3,7 +3,8 @@
   "type": "object",
   "properties": {
     "WebScience.SurveyId": {
-        "type": "string"
+        "type": "string",
+        "description": "ID sent to Qualtrics, for associating survey responses with telemetry data"
     },
     "WebScience.Measurements.PageNavigation": {
       "type": "object",
@@ -60,7 +61,11 @@
                   "type": "object",
                   "properties": {
                     "domain": { "type": "string" },
-                    "classification": { "type": "integer" },
+                    "classification": {
+                        "type": "string",
+                        "description": "deprecated, use pageClassification"
+                    },
+                    "pageClassification": { "type": "integer"},
                     "visitReferrer": { "type": "string" },
                     "audience": {
                       "type": "string",

validation/pioneer-citp-news-disinfo/measurements.1.sample.pass.json

@@ -31,7 +31,7 @@
         "trackedShares": [
           {
             "domain": "nytimes.com",
-            "classification": 0,
+            "pageClassification": 0,
             "audience": "public",
             "visitReferrer": "google.com",
             "numShares": 5,
@@ -40,7 +40,7 @@
           },
           {
             "domain": "nytimes.com",
-            "classification": 1,
+            "pageClassification": 1,
             "audience": "restricted",
             "visitReferrer": "google.com",
             "numShares": 3,
@@ -55,7 +55,7 @@
         "trackedShares": [
           {
             "domain": "nytimes.com",
-            "classification": 2,
+            "pageClassification": 2,
             "visitReferrer": "google.com",
             "audience": "public",
             "numShares": 2,