{"action":"created","issue":{"url":"https://api.github.com/repos/raml-org/raml-js-parser-2/issues/491","repository_url":"https://api.github.com/repos/raml-org/raml-js-parser-2","labels_url":"https://api.github.com/repos/raml-org/raml-js-parser-2/issues/491/labels{/name}","comments_url":"https://api.github.com/repos/raml-org/raml-js-parser-2/issues/491/comments","events_url":"https://api.github.com/repos/raml-org/raml-js-parser-2/issues/491/events","html_url":"https://github.com/raml-org/raml-js-parser-2/issues/491","id":180668295,"number":491,"title":"Spike on the raml2obj schema","user":{"login":"ddenisenko","id":14824966,"avatar_url":"https://avatars.githubusercontent.com/u/14824966?v=3","gravatar_id":"","url":"https://api.github.com/users/ddenisenko","html_url":"https://github.com/ddenisenko","followers_url":"https://api.github.com/users/ddenisenko/followers","following_url":"https://api.github.com/users/ddenisenko/following{/other_user}","gists_url":"https://api.github.com/users/ddenisenko/gists{/gist_id}","starred_url":"https://api.github.com/users/ddenisenko/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ddenisenko/subscriptions","organizations_url":"https://api.github.com/users/ddenisenko/orgs","repos_url":"https://api.github.com/users/ddenisenko/repos","events_url":"https://api.github.com/users/ddenisenko/events{/privacy}","received_events_url":"https://api.github.com/users/ddenisenko/received_events","type":"User","site_admin":false},"labels":[{"id":279347817,"url":"https://api.github.com/repos/raml-org/raml-js-parser-2/labels/enhancement","name":"enhancement","color":"84b6eb","default":true}],"state":"open","locked":false,"assignee":{"login":"KonstantinSviridov","id":6206034,"avatar_url":"https://avatars.githubusercontent.com/u/6206034?v=3","gravatar_id":"","url":"https://api.github.com/users/KonstantinSviridov","html_url":"https://github.com/KonstantinSviridov","followers_url":"https://api.github.com/users/KonstantinSviridov/followers","following_url":"https://api.github.com/users/KonstantinSviridov/following{/other_user}","gists_url":"https://api.github.com/users/KonstantinSviridov/gists{/gist_id}","starred_url":"https://api.github.com/users/KonstantinSviridov/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/KonstantinSviridov/subscriptions","organizations_url":"https://api.github.com/users/KonstantinSviridov/orgs","repos_url":"https://api.github.com/users/KonstantinSviridov/repos","events_url":"https://api.github.com/users/KonstantinSviridov/events{/privacy}","received_events_url":"https://api.github.com/users/KonstantinSviridov/received_events","type":"User","site_admin":false},"assignees":[{"login":"KonstantinSviridov","id":6206034,"avatar_url":"https://avatars.githubusercontent.com/u/6206034?v=3","gravatar_id":"","url":"https://api.github.com/users/KonstantinSviridov","html_url":"https://github.com/KonstantinSviridov","followers_url":"https://api.github.com/users/KonstantinSviridov/followers","following_url":"https://api.github.com/users/KonstantinSviridov/following{/other_user}","gists_url":"https://api.github.com/users/KonstantinSviridov/gists{/gist_id}","starred_url":"https://api.github.com/users/KonstantinSviridov/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/KonstantinSviridov/subscriptions","organizations_url":"https://api.github.com/users/KonstantinSviridov/orgs","repos_url":"https://api.github.com/users/KonstantinSviridov/repos","events_url":"https://api.github.com/users/KonstantinSviridov/events{/privacy}","received_events_url":"https://api.github.com/users/KonstantinSviridov/received_events","type":"User","site_admin":false}],"milestone":null,"comments":4,"created_at":"2016-10-03T15:20:18Z","updated_at":"2016-11-09T19:15:52Z","closed_at":null,"body":"It looks like https://github.com/raml2html/raml2obj has a number of improvements to the parser JSON format, we should check it and see if we can add some of those to the next generation of parser output.\n"},"comment":{"url":"https://api.github.com/repos/raml-org/raml-js-parser-2/issues/comments/259499945","html_url":"https://github.com/raml-org/raml-js-parser-2/issues/491#issuecomment-259499945","issue_url":"https://api.github.com/repos/raml-org/raml-js-parser-2/issues/491","id":259499945,"user":{"login":"kevinrenskers","id":229384,"avatar_url":"https://avatars.githubusercontent.com/u/229384?v=3","gravatar_id":"","url":"https://api.github.com/users/kevinrenskers","html_url":"https://github.com/kevinrenskers","followers_url":"https://api.github.com/users/kevinrenskers/followers","following_url":"https://api.github.com/users/kevinrenskers/following{/other_user}","gists_url":"https://api.github.com/users/kevinrenskers/gists{/gist_id}","starred_url":"https://api.github.com/users/kevinrenskers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kevinrenskers/subscriptions","organizations_url":"https://api.github.com/users/kevinrenskers/orgs","repos_url":"https://api.github.com/users/kevinrenskers/repos","events_url":"https://api.github.com/users/kevinrenskers/events{/privacy}","received_events_url":"https://api.github.com/users/kevinrenskers/received_events","type":"User","site_admin":false},"created_at":"2016-11-09T19:15:52Z","updated_at":"2016-11-09T19:15:52Z","body":"I agree with you. `allUriParameters` is purely a raml2html thing, it should not be part of the official parser.\r\n\r\nMy biggest problems with the parser are indeed the inconsistencies of the output, exactly like you described. Like types and example. Also, there's `examples` and `example` which is just annoying to work with from the clients point of view. Just always make it an array, even if there is only one example. I really don't understand why the RAML spec has both of these in the first place. You say that always outputting `examples` loses the info of whether `examples` or `example` was used in the input RAML file. I wonder why any client rendering API docs would care. I just want consistent usable output without having to deal with so many double ways of doing things.\r\n\r\nAnd like already mentioned plenty times before, just make the output easier to work with. So no wrapped objects inside of arrays and stuff. I would definitely switch maps to arrays as well. The fact that maps are closer to input RAML doesn't really matter to anyone actually working with the output?\r\n\r\nI would like the addition of `completeRelativeUri`, and agree that `uniqueId` is purely raml2html related and should not be part of the parser output.\r\n\r\nMost of all though, any type of type expansion should be handled by the official parser, as it's just much to hard to get this right myself. Output size really shouldn't be a concern I think? You can always do it behind a parameter if you don't always want to do it. My bet is that basically everyone will use that flag to auto expand though :)"}}
{"actor":{"display_login":"kevinrenskers"}}