We will be adding
You can also use it as a template, and replace the "Container" entries with your own specification!
- Fill in the templates provided on Google Drive, and download as tsv. Add the files to the specifications folder here under a subfolder called "Container", along with an entry in configuration.yml.
- Connect to continuous integration (CircleCI), which automatically runs the openschemas/schema-builder container. You will also need to:
- (optional) define
GITHUB_EMAILas CircleCI environment variables under settings for a "bot Github account" that you can use to push content back to Github Pages
- After you add the variables, add the Github bot user to your repository as a collaborator
- In a different browser, accept the invitation, and then copy paste the CircleCI URL for the project and click "Follow Project"
- Finally, under the CircleCI project settings (still as the bot) click on Checkout SSH Keys and generate a key for the bot to use.
With this setup, you will automatically generate a mini site that mimicks the openschemas.github.io to share your specifications.
Importantly, if you look at the Github pages branch, you have a folder of your specification files,
along with a folder of the rendered templates (that you can submit to
for final contribution of your schema!
But never fear if you don't want to connect to Github pages, these same files are saved as "artifacts" under the circle build (make sure to look under the build step of the workflow):
Finally, we want to contribute our specifications! This is actually much easier than you
might think. Just grab the file on github pages (or as an artifact) that corresponds to
(e.g Container.html or DataCatalog.html in the images above). And then:
- Fork the specifications repository.
- Check out a new branch, add the file to the specifications folder, push
- Open a pull request!
That should be it! We are in the process of writing tests so that the contributions there will be properly tested. Stay tuned!