{"action":"created","issue":{"url":"https://api.github.com/repos/raml2html/raml2html/issues/254","repository_url":"https://api.github.com/repos/raml2html/raml2html","labels_url":"https://api.github.com/repos/raml2html/raml2html/issues/254/labels{/name}","comments_url":"https://api.github.com/repos/raml2html/raml2html/issues/254/comments","events_url":"https://api.github.com/repos/raml2html/raml2html/issues/254/events","html_url":"https://github.com/raml2html/raml2html/issues/254","id":170511596,"number":254,"title":"RAML 1.0 support - progress, questions, help needed, etc","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},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":9,"created_at":"2016-08-10T20:31:44Z","updated_at":"2016-08-30T15:48:00Z","closed_at":null,"body":"I've just published raml2obj 4.0.0-beta1 with the most basic RAML 1.0 support, and raml2html 4.0.0-beta1 which uses that new version of raml2obj. However, **the templates in raml2html do not work with RAML 1.0 files, so we don't have RAML 1.0 support yet**!\r\n\r\nThere have been 2 branches here to add RAML 1.0 support, but in my opinion we should not continue with those. Adding RAML 1.0 support in the current templates is a waste of time since we're now going to build new templates anyway. I also think we really need to focus on making raml2obj spit out a unified format across RAML 0.8 and 1.0 files. That way clients like raml2html and raml2md only have to worry about rendering that format, instead of having a bunch of if-statements and hacks to support both RAML versions. raml2obj needs to do the heavy lifting.\r\n\r\nSo..\r\n\r\n1. Remove the two RAML 1.0 branches and focus on the develop branch instead.\r\n2. Make raml2obj do the heavy lifting and spit out a unified format.\r\n3. Write new templates using that new unified format.\r\n\r\n**What I need from the RAML Workgroup, or someone from the community, is awesome example files for both RAML 0.8 and 1.0 which include all the features that raml2html needs to support. I can then see how raml2obj needs to change.**\r\n\r\nI do believe that this is the most sensible way forward, but it does mean we have to focus on raml2obj, RAML 1.0 support and unified JS object, before even starting on the new templates."},"comment":{"url":"https://api.github.com/repos/raml2html/raml2html/issues/comments/243485398","html_url":"https://github.com/raml2html/raml2html/issues/254#issuecomment-243485398","issue_url":"https://api.github.com/repos/raml2html/raml2html/issues/254","id":243485398,"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-08-30T15:48:00Z","updated_at":"2016-08-30T15:48:00Z","body":"@fesor sounds good, but I just don't know enough about it yet :)\r\n@kevinduffey if it's not in the standard then we shouldn't add it."}}
{"actor":{"display_login":"kevinrenskers"}}