From e1341bc6d957d70a386c858cbdb64af5f284fd07 Mon Sep 17 00:00:00 2001 From: Fabio Berger Date: Wed, 21 Mar 2018 18:55:59 +0000 Subject: Move docs to page and add link to docs to README --- packages/json-schemas/README.md | 19 +++++++++---------- packages/website/md/docs/json_schemas/usage.md | 14 ++++++++++++++ .../ts/containers/json_schemas_documentation.ts | 4 ++++ 3 files changed, 27 insertions(+), 10 deletions(-) create mode 100644 packages/website/md/docs/json_schemas/usage.md (limited to 'packages') diff --git a/packages/json-schemas/README.md b/packages/json-schemas/README.md index 754ce4e95..961c3746d 100644 --- a/packages/json-schemas/README.md +++ b/packages/json-schemas/README.md @@ -2,25 +2,24 @@ Contains 0x-related json schemas +### Read the [Documentation](0xproject.com/docs/json-schemas). + ## Installation ```bash -yarn add @0xproject/json-schemas +npm install @0xproject/json-schemas --save ``` -## Usage +**Import** ```javascript -import {SchemaValidator, ValidatorResult, schemas} from '@0xproject/json-schemas'; +import { schemas } from '@0xproject/json-schemas'; +``` -const {orderSchema} = schemas; -const validator = new SchemaValidator(); +or -const order = { - ... -}; -const validatorResult: ValidatorResult = validator.validate(order, orderSchema); // Contains all errors -const isValid: boolean = validator.isValid(order, orderSchema); // Only returns boolean +```javascript +var schemas = require('@0xproject/json-schemas').schemas; ``` ## Contributing 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"'], -- cgit v1.2.3