2 files changed, 18 insertions, 0 deletions
diff --git a/packages/website/md/docs/json_schemas/usage.md b/packages/website/md/docs/json_schemas/usage.md
new file mode 100644
index 000000000..372c0b541
--- /dev/null
+++ b/packages/website/md/docs/json_schemas/usage.md
@@ -0,0 +1,14 @@
+The following example shows you how to validate an 0x order using the `@0xproject/json-schemas` package.
+
+```javascript
+import {SchemaValidator, ValidatorResult, schemas} from '@0xproject/json-schemas';
+
+const {orderSchema} = schemas;
+const validator = new SchemaValidator();
+
+const order = {
+    ...
+};
+const validatorResult: ValidatorResult = validator.validate(order, orderSchema); // Contains all errors
+const isValid: boolean = validator.isValid(order, orderSchema); // Only returns boolean
+```
diff --git a/packages/website/ts/containers/json_schemas_documentation.ts b/packages/website/ts/containers/json_schemas_documentation.ts
index 42e441212..154c65ffc 100644
--- a/packages/website/ts/containers/json_schemas_documentation.ts
+++ b/packages/website/ts/containers/json_schemas_documentation.ts
@@ -14,12 +14,14 @@ import { Translate } from 'ts/utils/translate';
 /* tslint:disable:no-var-requires */
 const IntroMarkdown = require('md/docs/json_schemas/introduction');
 const InstallationMarkdown = require('md/docs/json_schemas/installation');
+const UsageMarkdown = require('md/docs/json_schemas/usage');
 const SchemasMarkdown = require('md/docs/json_schemas/schemas');
 /* tslint:enable:no-var-requires */
 
 const docSections = {
     introduction: 'introduction',
     installation: 'installation',
+    usage: 'usage',
     schemaValidator: 'schemaValidator',
     schemas: 'schemas',
 };
@@ -32,6 +34,7 @@ const docsInfoConfig: DocsInfoConfig = {
     menu: {
         introduction: [docSections.introduction],
         install: [docSections.installation],
+        usage: [docSections.usage],
         schemaValidator: [docSections.schemaValidator],
         schemas: [docSections.schemas],
     },
@@ -39,6 +42,7 @@ const docsInfoConfig: DocsInfoConfig = {
         [docSections.introduction]: IntroMarkdown,
         [docSections.installation]: InstallationMarkdown,
         [docSections.schemas]: SchemasMarkdown,
+        [docSections.usage]: UsageMarkdown,
     },
     sectionNameToModulePath: {
         [docSections.schemaValidator]: ['"json-schemas/src/schema_validator"'],