{"action":"opened","issue":{"url":"https://api.github.com/repos/restful-api-description-language/RADL/issues/49","labels_url":"https://api.github.com/repos/restful-api-description-language/RADL/issues/49/labels{/name}","comments_url":"https://api.github.com/repos/restful-api-description-language/RADL/issues/49/comments","events_url":"https://api.github.com/repos/restful-api-description-language/RADL/issues/49/events","html_url":"https://github.com/restful-api-description-language/RADL/issues/49","id":112750195,"number":49,"title":"Write RADL for extended REST Services","user":{"login":"gentlewind","id":6801512,"avatar_url":"https://avatars.githubusercontent.com/u/6801512?v=3","gravatar_id":"","url":"https://api.github.com/users/gentlewind","html_url":"https://github.com/gentlewind","followers_url":"https://api.github.com/users/gentlewind/followers","following_url":"https://api.github.com/users/gentlewind/following{/other_user}","gists_url":"https://api.github.com/users/gentlewind/gists{/gist_id}","starred_url":"https://api.github.com/users/gentlewind/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gentlewind/subscriptions","organizations_url":"https://api.github.com/users/gentlewind/orgs","repos_url":"https://api.github.com/users/gentlewind/repos","events_url":"https://api.github.com/users/gentlewind/events{/privacy}","received_events_url":"https://api.github.com/users/gentlewind/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2015-10-22T08:01:17Z","updated_at":"2015-10-22T08:01:17Z","closed_at":null,"body":"Saying that the company ACME publishes a ACME Core REST Services with RADL documentation. Its customer extends the ACME REST Services and needs to document additional REST APIs into the RADL. There are several means to do this:\r\n* Modify the Core RADL directly, and re-generate the HTML doc.\r\n* Write the standalone RADL for the extended services, and merge with Core RADL by RADL Tool.\r\n\r\nThe latter approach has the advantage:\r\n＊it won't break or manipulate Core RADL\r\n＊it brings the opportunity to let multiple extended REST Services work together to build the entire & catorizied REST documentation"}}