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.
npm install raml-definition-system --save
npm install
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
.
npm run build
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
.
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: info@raml.org
Currently, the definition system provides interfaces for RAML 0.8 and 1.0 RC1 version.
Apache License 2.0