add sample file dataset-create-review.json #11747

Author: pdurbin

doc/sphinx-guides/source/_static/api/dataset-create-review.json

@@ -0,0 +1,93 @@
+{
+  "datasetType": "review",
+  "datasetVersion": {
+    "license": {
+      "name": "CC0 1.0",
+      "uri": "http://creativecommons.org/publicdomain/zero/1.0"
+    },
+    "metadataBlocks": {
+      "citation": {
+        "fields": [
+          {
+            "typeName": "title",
+            "value": "Review of Percent of Children That Have Asthma",
+            "typeClass": "primitive",
+            "multiple": false
+          },
+          {
+            "value": [
+              {
+                "authorName": {
+                  "value": "Wazowski, Mike",
+                  "typeClass": "primitive",
+                  "multiple": false,
+                  "typeName": "authorName"
+                }
+              }
+            ],
+            "typeClass": "compound",
+            "multiple": true,
+            "typeName": "author"
+          },
+          {
+            "value": [
+              {
+                "datasetContactEmail": {
+                  "value": "mwazowski@mailinator.com",
+                  "typeClass": "primitive",
+                  "multiple": false,
+                  "typeName": "datasetContactEmail"
+                }
+              }
+            ],
+            "typeClass": "compound",
+            "multiple": true,
+            "typeName": "datasetContact"
+          },
+          {
+            "value": [
+              {
+                "dsDescriptionValue": {
+                  "value": "This is a review of a dataset.",
+                  "typeClass": "primitive",
+                  "multiple": false,
+                  "typeName": "dsDescriptionValue"
+                }
+              }
+            ],
+            "typeClass": "compound",
+            "multiple": true,
+            "typeName": "dsDescription"
+          },
+          {
+            "value": [
+              "Medicine, Health and Life Sciences"
+            ],
+            "typeClass": "controlledVocabulary",
+            "multiple": true,
+            "typeName": "subject"
+          },
+          {
+            "value": {
+              "itemReviewedUrl": {
+                "value": "https://datacommons.org/tools/statvar#sv=Percent_Person_Children_WithAsthma",
+                "typeClass": "primitive",
+                "multiple": false,
+                "typeName": "itemReviewedUrl"
+              },
+              "itemReviewedType": {
+                "value": "Dataset",
+                "typeClass": "controlledVocabulary",
+                "multiple": false,
+                "typeName": "itemReviewedType"
+              }
+            },
+            "typeClass": "compound",
+            "multiple": false,
+            "typeName": "itemReviewed"
+          }
+        ]
+      }
+    }
+  }
+}

doc/sphinx-guides/source/user/dataset-management.rst

@@ -925,6 +925,9 @@ You can only create a review dataset if setup has already been done by a superus
 Review Datasets can only be created via API. You have the following options:
 
 - :ref:`api-create-dataset-with-type` (Native API)
+
+  - Here is an example JSON file for reference: :download:`dataset-create-review.json <../_static/api/dataset-create-review.json>`.
+
 - :ref:`api-semantic-create-dataset-with-type` (Semantic API)
 - :ref:`import-dataset-with-type`