Merge branch 'development' into feature/deployer-improvements

2 files changed, 32 insertions, 0 deletions

diff --git a/packages/json-schemas/src/monorepo_scripts/stage_docs.ts b/packages/json-schemas/src/monorepo_scripts/stage_docs.ts
new file mode 100644
index 000000000..e732ac8eb
--- /dev/null
+++ b/packages/json-schemas/src/monorepo_scripts/stage_docs.ts
@@ -0,0 +1,8 @@
+import { postpublishUtils } from '@0xproject/monorepo-scripts';
+
+import * as packageJSON from '../package.json';
+import * as tsConfigJSON from '../tsconfig.json';
+
+const cwd = `${__dirname}/..`;
+// tslint:disable-next-line:no-floating-promises
+postpublishUtils.publishDocsToStagingAsync(packageJSON, tsConfigJSON, cwd);
diff --git a/packages/json-schemas/src/schema_validator.ts b/packages/json-schemas/src/schema_validator.ts
index e13326d2a..38ae766e6 100644
--- a/packages/json-schemas/src/schema_validator.ts
+++ b/packages/json-schemas/src/schema_validator.ts
@@ -3,14 +3,26 @@ import values = require('lodash.values');
 
 import { schemas } from './schemas';
 
+/**
+ * A validator for [JSON-schemas](http://json-schema.org/)
+ */
 export class SchemaValidator {
     private _validator: Validator;
+    /**
+     * Instantiates a SchemaValidator instance
+     */
     constructor() {
         this._validator = new Validator();
         for (const schema of values(schemas)) {
             this._validator.addSchema(schema, schema.id);
         }
     }
+    /**
+     * Add a schema to the validator. All schemas and sub-schemas must be added to
+     * the validator before the `validate` and `isValid` methods can be called with
+     * instances of that schema.
+     * @param schema The schema to add
+     */
     public addSchema(schema: Schema) {
         this._validator.addSchema(schema, schema.id);
     }
@@ -18,10 +30,22 @@ export class SchemaValidator {
     // sub-types (e.g BigNumber) with a simpler string representation. Since BigNumber and other
     // complex types implement the `toString` method, we can stringify the object and
     // then parse it. The resultant object can then be checked using jsonschema.
+    /**
+     * Validate the JS object conforms to a specific JSON schema
+     * @param instance JS object in question
+     * @param schema Schema to check against
+     * @returns The results of the validation
+     */
     public validate(instance: any, schema: Schema): ValidatorResult {
         const jsonSchemaCompatibleObject = JSON.parse(JSON.stringify(instance));
         return this._validator.validate(jsonSchemaCompatibleObject, schema);
     }
+    /**
+     * Check whether an instance properly adheres to a JSON schema
+     * @param instance JS object in question
+     * @param schema Schema to check against
+     * @returns Whether or not the instance adheres to the schema
+     */
     public isValid(instance: any, schema: Schema): boolean {
         const isValid = this.validate(instance, schema).errors.length === 0;
         return isValid;