Iinitial set of annotations describing raml 2 java mapping #1
Conversation
| @@ -0,0 +1,100 @@ | |||
| #%RAML 1.0 Library | |||
| uses: | |||
| commons: "https://raw.githubusercontent.com/apiregistry/commons/master/commons.raml" | |||
There was a problem hiding this comment.
Should we include the commons RAML in here as well, or what is that exactly. I would argue to minimize the amount of external dependencies.
|
Hi Pavel, thanks! Looking at your PR, shall we create a specific folder called "sdks" or "sdk-generation" so that we can group them inside this repo? Also, it would be good to have a markdown file attached that explains the usage a bit and also where it can be used so far like in a table. I would also bring in your common annotations if necessary; but not sure if we should bring in information about the author etc inside the fragment file or inside the attached markdown. |
| types: | ||
| JavaPackage: string | ||
| TypeName: string | ||
| (commons.Authors): |
There was a problem hiding this comment.
Not sure about that to be honest. Its kinda additional information that you might want to have for building a separate registry, but there might be better options than putting it into the fragment file. Again, if its not import for the consumer (in this case the application that reads those annotations), I would try to bring in the meta information in a different form.
No description provided.