found 2 very nice projects which are used to develop REST APIs. They are designed high level and can be used for code generation and documentation.
with the ability to move swagger to raml using the project swagger to raml ( http://raml.org/projects/projects#q:swagger2raml ).
Important for me: both work with Java and .NET ... Swagger even has Client Generation for Angular (1 and 2).
Currently not available: .NET WebApi which would be great.