Generated html for the specific schema is written to ./docs/html/${UBI_VERSION}
.
pip install json-schema-for-humans
export UBI_VERSION=1.2.0
mkdir docs/html/${UBI_VERSION}
/Users/epugh/.asdf/installs/python/3.9.17/bin/generate-schema-doc --config-file jsfh-conf.yaml ./schema/$UBI_VERSION/ ./docs/html/$UBI_VERSION
We then check them into Github.
- Make sure to copy the last version (i.e.
schema/1.2.0)
to the next version (i.e.schema/1.3.0
) - Make sure to update the version information in each .json file.
- Build the docs into ./docs/html/1.3.0
- Update the virtual link to the latest version:
ln -s docs/html/1.3.0 docs/html/latest
ln -s docs/schema/1.3.0 docs/schema/latest
- Check in and merge the changes to the main branch.
- Create a release on Github.
- Post on Relevance Slack #user-behavior-insights channel.
- Update the ubisearch.dev site via https://github.com/o19s/ubi-website