One more documentation update iteration

config/commanders.json

@@ -29,7 +29,7 @@
 		{"ability": ["BLOCKS_RETALIATION", 0, 1, 0 ], "skills": [0,5]},
 		{"ability": ["UNLIMITED_RETALIATIONS", 0, 0, 0 ], "skills": [1, 2]},
 		{"ability": ["ATTACKS_ALL_ADJACENT", 0, 0, 0 ], "skills": [1, 3]},
-		{"ability": ["BLOCK", 30, 0, 0 ], "skills": [1, 4]},
+		{"ability": ["NONE", 30, 0, 0 ], "skills": [1, 4]}, // TODO: Implement bonus that gives chance to completely block one enemy attack per turn
 		{"ability": ["FIRE_SHIELD", 1, 1, 0 ], "skills": [1, 5]},
 		{"ability": ["ADDITIONAL_ATTACK", 1, 0, 0 ], "skills": [2, 3]},
 		{"ability": ["HP_REGENERATION", 50, 0, 0 ], "skills": [2, 4]},

config/schemas/battlefield.json

@@ -8,7 +8,7 @@
 	"properties" : {
 		"name" : {
 			"type" : "string",
-			"description" : "Name of the battleground"
+			"description" : "Human-readable name of the battlefield"
 		},
 		"isSpecial" : {
 			"type" : "boolean",
@@ -16,17 +16,17 @@
 		},
 		"bonuses": {
 			"type":"array",
-			"description": "Bonuses provided by this battleground using bonus system",
+			"description": "List of bonuses that will affect all battles on this battlefield",
 			"items": { "$ref" : "bonus.json" }
 		},
 		"graphics" : {
 			"type" : "string",
 			"format" : "imageFile",
-			"description" : "BMP battleground resource"
+			"description" : "Background image for this battlefield"
 		},
 		"impassableHexes" : {
 			"type" : "array",
-			"description" : "Battle hexes always impassable for this type of battlefield (ship to ship for instance)",
+			"description" : "List of battle hexes that will be always blocked on this battlefield (e.g. ship to ship battles)",
 			"items" : {
 				"type" : "number"
 			}

config/schemas/hero.json

@@ -114,16 +114,17 @@
 			"properties" : { 
 				"base" : {
 					"type" : "object",
-					"description" : "Will be merged with all bonuses."
+					"additionalProperties" : true,
+					"description" : "Section that will be added into every bonus instance, for use in specialties with multiple similar bonuses."
 				},
 				"bonuses" : {
 					"type" : "object",
-					"description" : "Set of bonuses",
+					"description" : "List of bonuses added by this specialty. See bonus format for more details",
 					"additionalProperties" : { "$ref" : "bonus.json" }
 				},
 				"creature" : {
 					"type" : "string",
-					"description" : "Name of base creature to grant standard specialty to."
+					"description" : "Shortcut for defining creature specialty, using standard H3 rules."
 				}
 			}
 		},

config/schemas/heroClass.json

@@ -54,10 +54,15 @@
 			}
 		},
 		"mapObject" : {
+			// TODO: this entry should be merged with corresponding base entry in hero object type and validated as objectType
+			// "$ref" : "objectType.json",
+			"type" : "object",
 			"properties" : {
 				"filters" : {
 					"type" : "object",
-					"additionalProperties" : { "type" : "array" }
+					"additionalProperties" : { 
+						"type" : "array" 
+					}
 				}
 			}
 		},

config/schemas/obstacle.json

@@ -16,12 +16,12 @@
 	"properties" : {
 		"allowedTerrains" : {
 			"type" : "array",
-			"description" : "Obstacles can be place on specified terrains only",
+			"description" : "List of terrains on which this obstacle can be used",
 			"items" : { "type" : "string" }
 		},
 		"specialBattlefields" : {
 			"type" : "array",
-			"description" : "Obstacles can be placed on specified specified battlefields",
+			"description" : "List of special battlefields on which this obstacle can be used",
 			"items" : { "type" : "string" }
 		},
 		"absolute" : {