Skip to content

Generate markdown documents from JSON schema files.

License

Notifications You must be signed in to change notification settings

twelvelabs/schemadoc

Repository files navigation

schemadoc

build codecov

Generate markdown documents from JSON schema files ✨.

Installation

Choose one of the following:

  • Download and manually install the latest release

  • Install with Homebrew 🍺

    brew install twelvelabs/tap/schemadoc
  • Install from source

    go install github.com/twelvelabs/schemadoc@latest

Usage

# Renders `./my.schema.json` to `./out/SchemaTitle.md`.
schemadoc gen --in ./my.schema.json

# Renders all json schema files in `./schemas` to `./docs`.
schemadoc gen --in ./schemas --out ./docs

Development

git clone git@github.com:twelvelabs/schemadoc.git
cd schemadoc

# Ensures all required dependencies are installed
# and bootstraps the project for local development.
make setup

make build
make test
make install

# Show help.
make