{"action":"created","issue":{"url":"https://api.github.com/repos/opal/opal/issues/1027","labels_url":"https://api.github.com/repos/opal/opal/issues/1027/labels{/name}","comments_url":"https://api.github.com/repos/opal/opal/issues/1027/comments","events_url":"https://api.github.com/repos/opal/opal/issues/1027/events","html_url":"https://github.com/opal/opal/issues/1027","id":97126755,"number":1027,"title":"Missing API documentation for Native","user":{"login":"Ajedi32","id":1876931,"avatar_url":"https://avatars.githubusercontent.com/u/1876931?v=3","gravatar_id":"","url":"https://api.github.com/users/Ajedi32","html_url":"https://github.com/Ajedi32","followers_url":"https://api.github.com/users/Ajedi32/followers","following_url":"https://api.github.com/users/Ajedi32/following{/other_user}","gists_url":"https://api.github.com/users/Ajedi32/gists{/gist_id}","starred_url":"https://api.github.com/users/Ajedi32/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Ajedi32/subscriptions","organizations_url":"https://api.github.com/users/Ajedi32/orgs","repos_url":"https://api.github.com/users/Ajedi32/repos","events_url":"https://api.github.com/users/Ajedi32/events{/privacy}","received_events_url":"https://api.github.com/users/Ajedi32/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-07-24T19:34:19Z","updated_at":"2015-07-24T20:11:24Z","closed_at":null,"body":"Opal is currently missing API documentation for the `Native` class. This should be added.\r\n\r\n----\r\n\r\nThis issue was created in response to the following conversation in issue #1024:\r\n\r\n@ajedi32:\r\n> My guess is you'd have to use Hash#to_native or #to_n or something? That doesn't seem to be documented anywhere though either, is it?\r\n\r\n@ajedi32:\r\n>Maybe some RDoc comments could be added to https://github.com/opal/opal/blob/master/stdlib/native.rb#L489-L520? Then we'd just need to use them to generate HTML and host them them somewhere. Better docs for some of the Opal-specific classes and methods / method implementations would be great.\r\n\r\n\r\n@elia:\r\n> yes, actually there's already a place for that kind of docs at http://opalrb.org/docs/ under \"API documentation\". It's unfortunate that for some reason Native isn't covered and we need to fix that.\r\n>\r\n> As of the array to_n should call to_n on all its elements, if it doesn't let me know and we'll ask @meh to fix it :blush:\r\n\r\n"},"comment":{"url":"https://api.github.com/repos/opal/opal/issues/comments/124702648","html_url":"https://github.com/opal/opal/issues/1027#issuecomment-124702648","issue_url":"https://api.github.com/repos/opal/opal/issues/1027","id":124702648,"user":{"login":"Ajedi32","id":1876931,"avatar_url":"https://avatars.githubusercontent.com/u/1876931?v=3","gravatar_id":"","url":"https://api.github.com/users/Ajedi32","html_url":"https://github.com/Ajedi32","followers_url":"https://api.github.com/users/Ajedi32/followers","following_url":"https://api.github.com/users/Ajedi32/following{/other_user}","gists_url":"https://api.github.com/users/Ajedi32/gists{/gist_id}","starred_url":"https://api.github.com/users/Ajedi32/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Ajedi32/subscriptions","organizations_url":"https://api.github.com/users/Ajedi32/orgs","repos_url":"https://api.github.com/users/Ajedi32/repos","events_url":"https://api.github.com/users/Ajedi32/events{/privacy}","received_events_url":"https://api.github.com/users/Ajedi32/received_events","type":"User","site_admin":false},"created_at":"2015-07-24T20:11:24Z","updated_at":"2015-07-24T20:11:24Z","body":"This particular issue is about adding API *documentation* for the `Native` class. Fixing any incorrect behavior is a related but separate issue, IMO."}}