json_validation_process.md

Validating vulkaninfo JSON output

The format of vulkaninfo's JSON output is designed to be used as input for the Vulkan Profiles solution.

The Vulkan Profiles JSON schema specifies exactly how the JSON must be structured. The schemas may be found at here. Select the latest schema that vulkaninfo was designed to be used with, or simply take the latest available schema.

Steps to validate JSON data against the Vulkan Profiles schema

1. Generate the text to be tested using vulkaninfo --json which creates a .json file automatically.
2. Download the Vulkan Profiles schema to another file.
3. For each of the on-line JSON validator tools listed below:
   1. Paste the schema and and sample text into the schema and data fields.
   2. Depending on the tool, it may validate automatically, or require clicking a validate button.
   3. Ensure the tool reports no errors.

List of recommended JSON validator tools

• https://www.jsonschemavalidator.net/
• https://jsonschemalint.com/#/version/draft-04/markup/json
• https://json-schema-validator.herokuapp.com/index.jsp