set up github.io with schema as markdown (input for mkdocs)
Opened this issue · 2 comments
dosumis commented
Aim: generate browsable, human-readable documentation of DOSDP JSON SCHEMA
- Research existing auto-documentation options - markdown output preferred, but we could use static html generator if better.
- ...
hkir-dev commented
First version of the auto-generated documentation exists here
Used jsonschema2md for basic generation and decorated by using a custom config file.
For this task, needed to update (such as adding doc_type etc.) existing schema a little: new schema
Can you share your recommendations for better a documentation.
hkir-dev commented
Mkdocs documentation publishing completed: https://incatools.github.io/dead_simple_owl_design_patterns/
Github action is triggered when; new release, updating README.md or files under docs/ (in the master branch only)