Merge branch 'development'

* development: (175 commits)
  small README fixes
  Update docs list in README
  Add manual postpublish command to all public packages and update CHANGELOG.json
  Fix postpublish util to ignore namespace
  Fix release notes bug
  Should print out `lerna publish` stdout so we can see if anything went wrong
  Publish
  Updated CHANGELOGS
  Generate CHANGELOG.json files
  Fix hasty find/replace
  Default to 4sp
  Update moment, no longer need separate moment types
  Move prettify command to utils and also call it on CHANGELOG.md
  Add prettier run on generated CHANGELOG.json and fix scripts
  Remove semi-colons from monorepo-scripts package.json
  Get rid of ; in top-level package.json
  Fix TSLint error
  Make dry-run configurable from top-level package.json
  Improve naming
  Run prettier, update deployer CHANGELOG
  ...

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;