diff --git a/source/behavior/dialogue/1.14.0/dialogue.json b/source/behavior/dialogue/1.14.0/dialogue.json
index c5187471..0f52c20f 100644
--- a/source/behavior/dialogue/1.14.0/dialogue.json
+++ b/source/behavior/dialogue/1.14.0/dialogue.json
@@ -8,7 +8,6 @@
   "required": ["format_version", "minecraft:npc_dialogue"],
   "properties": {
     "format_version": {
-      "const": "1.14.0",
       "type": "string",
       "description": "Specifies the version of the game this entity was made in. Minimum supported version is 1.14.0. Current supported version is 1.14.0.",
       "title": "Format Version"
@@ -32,35 +31,32 @@
             "$comment": "UNDOCUMENTED",
             "type": "object",
             "additionalProperties": false,
+            "required": ["scene_tag"],
+            "examples": [{ "scene_tag": "foo_intro" }],
             "properties": {
               "buttons": {
                 "title": "Buttons",
-                "description": "UNDOCUMENTED",
-                "$comment": "UNDOCUMENTED",
+                "description": "This is where you can create buttons for your NPC",
                 "type": "array",
                 "maxItems": 6,
                 "items": {
                   "title": "Button",
-                  "description": "UNDOCUMENTED",
-                  "$comment": "UNDOCUMENTED",
+                  "description": "This is where you can create buttons for your NPC",
                   "type": "object",
                   "additionalProperties": false,
                   "properties": {
                     "name": {
                       "title": "Name",
-                      "description": "UNDOCUMENTED",
-                      "$comment": "UNDOCUMENTED",
+                      "description": "Set the text that is going to be displayed on your NPC’s button",
                       "$ref": "../../../general/rawtext/rawtext.json"
                     },
                     "commands": {
                       "type": "array",
-                      "description": "UNDOCUMENTED",
-                      "$comment": "UNDOCUMENTED",
+                      "description": "allows you to add commands which will be run in-game when the button is pressed",
                       "title": "Commands",
                       "items": {
                         "title": "Minecraft Command",
-                        "description": "UNDOCUMENTED",
-                        "$comment": "UNDOCUMENTED",
+                        "description": "The commands to execute",
                         "type": "string",
                         "pattern": "^/[a-z].*$"
                       }
@@ -70,33 +66,39 @@
               },
               "npc_name": {
                 "title": "NPC Name",
-                "description": "UNDOCUMENTED",
-                "$comment": "UNDOCUMENTED",
+                "description": "This is where you can add or change a name for your NPC dialogue box. This is an optional property that is useful for dynamically changing NPC names.",
                 "$ref": "../../../general/rawtext/rawtext.json"
               },
               "on_close_commands": {
                 "type": "array",
-                "description": "UNDOCUMENTED",
-                "$comment": "UNDOCUMENTED",
+                "description": "This is where you can define which commands will fire when the NPC dialogue box closes",
                 "title": "On Close Commands",
                 "items": {
                   "title": "Minecraft Command",
-                  "description": "UNDOCUMENTED",
-                  "$comment": "UNDOCUMENTED",
+                  "description": "A minecraft command to execute",
+                  "type": "string",
+                  "pattern": "^/[a-z].*$"
+                }
+              },
+              "on_open_commands": {
+                "type": "array",
+                "description": "This is where you can define which commands will fire when the NPC dialogue box opens",
+                "title": "On Close Commands",
+                "items": {
+                  "title": "Minecraft Command",
+                  "description": "A minecraft command to execute",
                   "type": "string",
                   "pattern": "^/[a-z].*$"
                 }
               },
               "scene_tag": {
                 "title": "Scene Tag",
-                "description": "UNDOCUMENTED",
-                "$comment": "UNDOCUMENTED",
+                "description": "This is the name you will use to call this scene in-game. This is a required property.",
                 "type": "string"
               },
               "text": {
                 "title": "Text",
-                "description": "UNDOCUMENTED",
-                "$comment": "UNDOCUMENTED",
+                "description": "This is where you enter the dialogue you want your NPC to display in-game for this scene. You can type the dialogue text directly here or use raw text if you are using a language file. This is an optional property, but without it your NPC dialogue box will be empty.",
                 "$ref": "../../../general/rawtext/rawtext.json"
               }
             }
diff --git a/source/behavior/dialogue/dialogue.json b/source/behavior/dialogue/dialogue.json
index 1613bea3..4eee1053 100644
--- a/source/behavior/dialogue/dialogue.json
+++ b/source/behavior/dialogue/dialogue.json
@@ -18,6 +18,8 @@
   "allOf": [
     { "if": { "properties": { "format_version": { "type": "string", "const": "1.14.0" } } }, "then": { "$ref": "./1.14.0/dialogue.json" } },
     { "if": { "properties": { "format_version": { "type": "string", "const": "1.14" } } }, "then": { "$ref": "./1.14.0/dialogue.json" } },
+    { "if": { "properties": { "format_version": { "type": "string", "const": "1.17.0" } } }, "then": { "$ref": "./1.14.0/dialogue.json" } },
+    { "if": { "properties": { "format_version": { "type": "string", "const": "1.17" } } }, "then": { "$ref": "./1.14.0/dialogue.json" } },
     { "properties": { "format_version": { "$ref": "../../general/format_version.json" } } }
   ]
 }