Describe Data: provide example of datashape definition

This is a…

[x ] Feature request
[ ] Regression (a behavior that used to work and stopped working in a new release)
[ ] Bug report  
[ ] Documentation issue or request

The problem

Currently the definition textarea is blank. Could we provide an example definition to outline format, required fields etc? Or we just entirely fallback to docs here?

Screenshot

[TovaCohen]

For the Specify Input/Output Data Type page, the user documentation provides this information:

Select one of the following as the schema type:

• JSON schema is a document that describes the structure of JSON data. The document’s media type is application/schema+json.
• JSON instance is a document that contains JSON data. The document’s media type is application/json.
• XML schema is a document that describes the structure of XML data. The document’s file extension is .xsd.
• XML instance is a document that contains XML data. The document’s file extension is .xml.

In the Definition input box, paste a definition that conforms to the schema type you selected. For example, if you select JSON schema then you would paste the content of a JSON schema file, which has a media type of application/schema+json.

However, the page does not provide hover help for input fields. Can this be added? I suggest:

Select Type Indicate how you are specifying the data type.

Definition Paste or write content for the type you selected, for example, for JSON Schema, paste the content of a document whose media type is application/schema+json.

Data Type Name Enter a name that you choose. This name will appear in the data mapper.

Data Type Description Enter any information about this data type that might be helpful to you.

[dsimansk]

@gashcrumb I’m fine with that. I’ll remove TP4 label and keep this as a possible enhancement once validation is also available? Wdyt?