Minor suggestion: in your example and docs put the raml under /src/main/raml instead of src/main/resources

[ryangardner]

With maven, most codegen tools have you put your codegen source in a different source path like:

src/main/raml

This is preferred to using src/main/resources for a file because it makes it more obvious to users that it's not just a run-time resource but it's actually some form of "source" used for code generation.

[petrochenko-pavel-a]

It is done.