EDDN/docs/Adding-A-New-Schema.md
Athanasius 7f6fe9cd76
docs/Adding-A-New-Schema: Reference Contributing.md section
We might just remove this file, but it can stay for now.
2022-01-30 17:43:34 +00:00

1.0 KiB

Adding A New Schema

Introduction

As of September 2021 it was decided that all new Journal events will be added to their own, new, schemas. This better facilitates defining any values that should be elided, or augmentations added, without twisting schema definitions into knots.

Consult Contributing.md#adding-a-new-schema for guidelines on the specifics of proposing and designing a new Scema.

In the future we will likely migrate all of the events currently supported in the journal schema into their own schemas, and later still deprecate the journal schema.

Code changes

The only code change required is to src/conf/Settings.py in the GATEWAY_JSON_SCHEMAS dictionary. This defines the schemas the Gateway will accept, and the local schema file to check each against.

Deployment changes

As of 2021-09-23 all of the setup.py deployment code operates on file globs or directories, so no changes are necessary in order to get new schema files deployed.