Stable version

[alecsammon]

What do we need to get a first stable version out?

My current thoughts

• More support of the complete RAML spec
• A fixed interface for the classes
• A refactor of the tests
• Better test coverage, with more full example RAML files

A nice to have would be the ability to convert the API Definition back into a RAML file. This would be a useful feature anyway, but also would make testing quite easy. Parse a RAML file, convert it back to RAML and ensure that they are the same.

[titomiguelcosta]

+1 to the idea of being able to dump the contents back to a raml file. We could have a factory like the Yaml library has, Yaml::dump() and Yaml::parse(). Still, I do not think we can compare input with the output and expect to be exactly the same, since we can have multiple !include statements and we do a merge of the query parameters, we do not want to keep track of all that to output later on.

[brendo]

More support of the complete RAML spec

On this note, I wonder if it's worth waiting for the RAML 1.0 spec to drop and then target this for the 1.0.0 release? I have yet to fully digest the upcoming RAML changes, so I'm not sure what would be required to maintain RAML 0.8 and RAML 1.0 parsing support.

A nice to have would be the ability to convert the API Definition back into a RAML file.

That'd be pretty awesome.

At lot of ground has been made recently, this project is zooming along :)

[alecsammon]

Thanks @brendo, yeah the project is starting to make really good progress now - I'm excited by it.

I'm not sure how to approach the RAML 1.0 spec. Do we try and support both, or have a stable version with support for 0.8 and then backport bug fixes, and start a new version for 1.0. I'm not sure how easy it would be to have support for both 0.8 and 1.0 at the same time either.

I'm keen to have a stable version as soon as possible, even if that means it doesn't support 1.0, so my preference would be to get the 1.0.0 out asap, and then start thinking properly about the RAML 1.0 spec

[alecsammon]

This is a very early look at how I would like the library to look for stable release. I've a lot more work to do before I'm happy, but better to get comment not then when it's completed

[alecsammon]

Just to note - I'm rewriting history on this branch - let me know if you start working from it