No. 20 of 38 ·Documentation Generators

JSON Schema for Humans

Windows · Mac · Linux · Self-hosted

Freedom report

One barScore 5.3

JSON Schema for Humans is ranked #20 of 38 in documentation generators on Freedom251. It runs on Linux, macOS, Self-hosted, Windows.

Compared on documentation generators

Purpose: Generates static HTML or Markdown pages documenting JSON Schemas.
Install: The project documents installation with `pip install json-schema-for-humans`.
Ways to use: It offers a command-line interface and Python methods for generating documentation.
Schema references: It supports references within a schema, to local files, and to URLs, including circular references.
Interactive HTML: The default JavaScript template provides expandable sections, tabs for conditional subschemas, and anchor links.
Offline output: The `js_offline` template bundles CSS and JavaScript resources for offline use.
Markdown publishing: The Markdown template can be published without hosting an HTTP server, and GitHub renders it when browsing code.
Integrations: A `techdocs` template is described as optimized for TechDocs and MkDocs Material.
Limits: The README lists property names and size, property dependencies, and media as currently unsupported.
Input requirements: Inputs must be valid JSON Schema in JSON or YAML format; the CLI accepts a file, directory, glob pattern, or comma-separated list.
Security setting: For HTML descriptions, the documented default safe mode escapes HTML tags; the configuration also permits null to allow HTML.
License: The repository says the software is licensed under the Apache License, Version 2.0.
Support: The project README invites contributions and directs users to its contributing guide.

Claim it for free: prove the domain, then correct facts, plans and screenshots. An editor reviews every change.