A Ruby CLI tool for scaffolding, verifying, and generating documentation from JSON Schema for HTTP APIs.
Prmd is a Ruby-based command-line tool for working with JSON Schema to describe HTTP APIs. It provides utilities to scaffold resource schemas, combine them with metadata, verify their correctness, and generate comprehensive API documentation. It solves the problem of maintaining consistent and up-to-date API documentation by automating the process from schema definitions.
API developers and teams designing HTTP APIs who want to use JSON Schema as a specification format and need tooling for scaffolding, validation, and documentation generation.
Developers choose Prmd for its focused workflow that integrates seamlessly with JSON Schema, its support for both JSON and YAML, and its ability to automate documentation generation, reducing manual upkeep and ensuring documentation stays synchronized with the API design.
JSON Schema tools and doc generation for HTTP APIs
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
The `init` command bootstraps JSON Schema files for API resources, speeding up initial design and ensuring consistent structure across resources.
`doc` generates human-readable Markdown documentation from schema files, reducing manual upkeep and keeping docs in sync with API changes.
Supports both JSON and YAML for schemata and metadata, allowing teams to mix formats and choose based on preference, as shown with the `--yaml` flag.
`verify` checks schema completeness and correctness, helping catch errors early in the design phase before implementation.
Includes Rake tasks for automating schema combination, verification, and documentation in Ruby workflows, streamlining CI/CD pipelines.
Does not support other API specification standards like OpenAPI, which are more widely adopted, potentially restricting tool interoperability.
Generates only static Markdown files without interactive elements like API testing or real-time previews, unlike tools such as Swagger UI.
Requires adherence to specific JSON Schema conventions detailed in /docs/schemata.md, adding learning curve and risk of misuse for newcomers.