big tings

registry/schema-org/Review.schema.json

@@ -0,0 +1,103 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "schema:Review",
+  "title": "Review",
+  "description": "A review of an item - for example, of a restaurant, movie, or store.",
+  "type": "object",
+  "allOf": [
+    {
+      "description": "The most generic kind of creative work, including books, movies, photographs, software programs, etc.",
+      "$ref": "schema:CreativeWork"
+    }
+  ],
+  "properties": {
+    "associatedClaimReview": {
+      "description": "An associated [[ClaimReview]], related by specific common content, topic or claim. The expectation is that this property would be most typically used in cases where a single activity is conducting both claim reviews and media reviews, in which case [[relatedMediaReview]] would commonly be used on a [[ClaimReview]], while [[relatedClaimReview]] would be used on [[MediaReview]].",
+      "oneOf": [
+        { "$ref": "schema:Review" },
+        { "type": "array", "items": { "$ref": "schema:Review" } }
+      ]
+    },
+    "associatedMediaReview": {
+      "description": "An associated [[MediaReview]], related by specific common content, topic or claim. The expectation is that this property would be most typically used in cases where a single activity is conducting both claim reviews and media reviews, in which case [[relatedMediaReview]] would commonly be used on a [[ClaimReview]], while [[relatedClaimReview]] would be used on [[MediaReview]].",
+      "oneOf": [
+        { "$ref": "schema:Review" },
+        { "type": "array", "items": { "$ref": "schema:Review" } }
+      ]
+    },
+    "associatedReview": {
+      "description": "An associated [[Review]].",
+      "oneOf": [
+        { "$ref": "schema:Review" },
+        { "type": "array", "items": { "$ref": "schema:Review" } }
+      ]
+    },
+    "itemReviewed": {
+      "description": "The item that is being reviewed/rated.",
+      "$ref": "schema:Thing"
+    },
+    "negativeNotes": {
+      "description": "Provides negative considerations regarding something, most typically in pro/con lists for reviews (alongside [[positiveNotes]]). For symmetry \n\nIn the case of a [[Review]], the property describes the [[itemReviewed]] from the perspective of the review; in the case of a [[Product]], the product itself is being described. Since product descriptions \ntend to emphasise positive claims, it may be relatively unusual to find [[negativeNotes]] used in this way. Nevertheless for the sake of symmetry, [[negativeNotes]] can be used on [[Product]].\n\nThe property values can be expressed either as unstructured text (repeated as necessary), or if ordered, as a list (in which case the most negative is at the beginning of the list).",
+      "oneOf": [
+        {
+          "anyOf": [
+            { "type": "string" },
+            { "$ref": "schema:ItemList" },
+            { "$ref": "schema:ListItem" },
+            { "$ref": "schema:WebContent" }
+          ]
+        },
+        {
+          "type": "array",
+          "items": {
+            "anyOf": [
+              { "type": "string" },
+              { "$ref": "schema:ItemList" },
+              { "$ref": "schema:ListItem" },
+              { "$ref": "schema:WebContent" }
+            ]
+          }
+        }
+      ]
+    },
+    "positiveNotes": {
+      "description": "Provides positive considerations regarding something, for example product highlights or (alongside [[negativeNotes]]) pro/con lists for reviews.\n\nIn the case of a [[Review]], the property describes the [[itemReviewed]] from the perspective of the review; in the case of a [[Product]], the product itself is being described.\n\nThe property values can be expressed either as unstructured text (repeated as necessary), or if ordered, as a list (in which case the most positive is at the beginning of the list).",
+      "oneOf": [
+        {
+          "anyOf": [
+            { "type": "string" },
+            { "$ref": "schema:ItemList" },
+            { "$ref": "schema:ListItem" },
+            { "$ref": "schema:WebContent" }
+          ]
+        },
+        {
+          "type": "array",
+          "items": {
+            "anyOf": [
+              { "type": "string" },
+              { "$ref": "schema:ItemList" },
+              { "$ref": "schema:ListItem" },
+              { "$ref": "schema:WebContent" }
+            ]
+          }
+        }
+      ]
+    },
+    "reviewAspect": {
+      "description": "This Review or Rating is relevant to this part or facet of the itemReviewed.",
+      "oneOf": [
+        { "type": "string" },
+        { "type": "array", "items": { "type": "string" } }
+      ]
+    },
+    "reviewBody": {
+      "description": "The actual body of the review.",
+      "type": "string"
+    },
+    "reviewRating": {
+      "description": "The rating given in this review. Note that reviews can themselves be rated. The ```reviewRating``` applies to rating given by the review. The [[aggregateRating]] property applies to the review itself, as a creative work.",
+      "$ref": "schema:Rating"
+    }
+  }
+}