RAML Definition System
This repository contains a set of interfaces that represents a declarative description of the RAML specification.
IMPORTANT: This is still in development and should be considered alpha.
Installation
From NPM
npm install raml-definition-system --save
From Sources
npm install
Generate
Make sure you executed all necessary installation steps before you try to generate anything. See section From Sources for more information.
The result files can be found inside the dist/
repository ending with .json
.
Build Sources
npm run build
JSON Structure for the Definition System
One can either use the provided interfaces in TypeScript or a JSON representation of the definition system that can be generated by running either the [complete build](#build sources) or npm run generateJSON
.
Contribute
The raml-definition-system
is an open source project and any contribution is always welcome. Please bear in mind that the definition system is a full reflection of the RAML specification and must not contain anything that is not mentioned inside the specification. Therefore, contribution to the actual interfaces should be limited to bug fixes only.
- Check for open issues or open a fresh issue to start a discussion around an idea or a bug.
- Fork the repository on Github and make your changes on the develop branch (or branch off of it).
- Send a pull request (with the develop branch as the target).
A big thank you goes out to everyone who helped with the project, the contributors and everyone who took the time to report issues and give feedback.
You can also directly get in touch with us. Simply send us an email to: [email protected]
RAML version support
Currently, the definition system provides interfaces for RAML 0.8 and 1.0 RC1 version.
License
Apache License 2.0