fix: typo in then description

updates to other descriptions to clarify some behaviors

closes microsoft#250

src/services/configuration.ts

@@ -464,8 +464,8 @@ export const schemaContributions: ISchemaContributions = {
 const descriptions: { [prop: string]: string } = {
 	id: l10n.t("A unique identifier for the schema."),
 	$schema: l10n.t("The schema to verify this document against."),
-	title: l10n.t("A descriptive title of the element."),
-	description: l10n.t("A long description of the element. Used in hover menus and suggestions."),
+	title: l10n.t("A descriptive title of the schema."),
+	description: l10n.t("A long description of the schema. Used in hover menus and suggestions."),
 	default: l10n.t("A default value. Used by suggestions."),
 	multipleOf: l10n.t("A number that should cleanly divide the current value (i.e. have no remainder)."),
 	maximum: l10n.t("The maximum numerical value, inclusive by default."),
@@ -475,22 +475,22 @@ const descriptions: { [prop: string]: string } = {
 	maxLength: l10n.t("The maximum length of a string."),
 	minLength: l10n.t("The minimum length of a string."),
 	pattern: l10n.t("A regular expression to match the string against. It is not implicitly anchored."),
-	additionalItems: l10n.t("For arrays, only when items is set as an array. If it is a schema, then this schema validates items after the ones specified by the items array. If it is false, then additional items will cause validation to fail."),
+	additionalItems: l10n.t("For arrays, only when items is set as an array. If items are a schema, this schema validates items after the ones specified by the items schema. If false, additional items will cause validation to fail."),
 	items: l10n.t("For arrays. Can either be a schema to validate every element against or an array of schemas to validate each item against in order (the first schema will validate the first element, the second schema will validate the second element, and so on."),
 	maxItems: l10n.t("The maximum number of items that can be inside an array. Inclusive."),
 	minItems: l10n.t("The minimum number of items that can be inside an array. Inclusive."),
 	uniqueItems: l10n.t("If all of the items in the array must be unique. Defaults to false."),
 	maxProperties: l10n.t("The maximum number of properties an object can have. Inclusive."),
 	minProperties: l10n.t("The minimum number of properties an object can have. Inclusive."),
 	required: l10n.t("An array of strings that lists the names of all properties required on this object."),
-	additionalProperties: l10n.t("Either a schema or a boolean. If a schema, then used to validate all properties not matched by 'properties' or 'patternProperties'. If false, then any properties not matched by either will cause this schema to fail."),
+	additionalProperties: l10n.t("Either a schema or a boolean. If a schema, used to validate all properties not matched by 'properties', 'propertyNames', or 'patternProperties'. If false, any properties not defined by the adajacent keywords will cause this schema to fail."),
 	definitions: l10n.t("Not used for validation. Place subschemas here that you wish to reference inline with $ref."),
 	properties: l10n.t("A map of property names to schemas for each property."),
 	patternProperties: l10n.t("A map of regular expressions on property names to schemas for matching properties."),
 	dependencies: l10n.t("A map of property names to either an array of property names or a schema. An array of property names means the property named in the key depends on the properties in the array being present in the object in order to be valid. If the value is a schema, then the schema is only applied to the object if the property in the key exists on the object."),
 	enum: l10n.t("The set of literal values that are valid."),
 	type: l10n.t("Either a string of one of the basic schema types (number, integer, null, array, object, boolean, string) or an array of strings specifying a subset of those types."),
-	format: l10n.t("Describes the format expected for the value."),
+	format: l10n.t("Describes the format expected for the value. By default, not used for validation"),
 	allOf: l10n.t("An array of schemas, all of which must match."),
 	anyOf: l10n.t("An array of schemas, where at least one must match."),
 	oneOf: l10n.t("An array of schemas, exactly one of which must match."),
@@ -506,7 +506,7 @@ const descriptions: { [prop: string]: string } = {
 	contentMediaType: l10n.t("Describes the media type of a string property."),
 	contentEncoding: l10n.t("Describes the content encoding of a string property."),
 	if: l10n.t("The validation outcome of the \"if\" subschema controls which of the \"then\" or \"else\" keywords are evaluated."),
-	then: l10n.t("The \"if\" subschema is used for validation when the \"if\" subschema succeeds."),
+	then: l10n.t("The \"then\" subschema is used for validation when the \"if\" subschema succeeds."),
 	else: l10n.t("The \"else\" subschema is used for validation when the \"if\" subschema fails.")
 };