GCN Schema

This repository contains the schemas for crafting new GCN notices. It also includes mission-specific schemas and illustrative examples, which are distributed by GCN Kafka. The formulation of mission schemas is one step in the process for setting up New Notice Producers.

The alert format for new Notices over GCN Kafka is JavaScript Object Notation (JSON), a widely adopted Internet data format. We have designed a set of core schema which serve as the building blocks for new GCN Notices. Instrument-specific schema can also be created, but we request that you utilize the core schema as much as possible.

Please add your schema to this repository under gcn/notices/mission/ and submit a pull request for the GCN Team to review. The GCN team is happy to iterate with the producers on their schema contents and format. Your pipeline will generate JSON files following these schema and send alerts to GCN as described in New Notice Producers.

How To Release

1. Clone the parent repo (nasa-gcn/gcn-schema).

   git clone git@github.com:nasa-gcn/gcn-schema.git
   cd gcn-schema
   

2. Install necessary npm packages

   npm install
   

3. Tag a new version by running the following command: npm version [ major | minor | patch ]. Choose major, minor, or patch depending on the kind of update according to Semantic Versioning rules.

   This command will handle the intermediate steps of updating and committing the path changes in each file as defined in the version and postversion npm scripts

4. Review the changes with git log -p to make sure that each file is appropriately updated.

5. Finally, push both the commit and the tag:

   git push && git push origin <tag name>
   

This will make the release available for use. For subsequent releases:

1. Pull the latest state of the main branch

   git pull
   

2. Follow the above steps from Step 3 on.