{"action":"created","issue":{"url":"https://api.github.com/repos/mapbox/mapbox-gl-native/issues/2545","labels_url":"https://api.github.com/repos/mapbox/mapbox-gl-native/issues/2545/labels{/name}","comments_url":"https://api.github.com/repos/mapbox/mapbox-gl-native/issues/2545/comments","events_url":"https://api.github.com/repos/mapbox/mapbox-gl-native/issues/2545/events","html_url":"https://github.com/mapbox/mapbox-gl-native/issues/2545","id":110113998,"number":2545,"title":"Launch with high quality API","user":{"login":"ljbade","id":1215089,"avatar_url":"https://avatars.githubusercontent.com/u/1215089?v=3","gravatar_id":"","url":"https://api.github.com/users/ljbade","html_url":"https://github.com/ljbade","followers_url":"https://api.github.com/users/ljbade/followers","following_url":"https://api.github.com/users/ljbade/following{/other_user}","gists_url":"https://api.github.com/users/ljbade/gists{/gist_id}","starred_url":"https://api.github.com/users/ljbade/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ljbade/subscriptions","organizations_url":"https://api.github.com/users/ljbade/orgs","repos_url":"https://api.github.com/users/ljbade/repos","events_url":"https://api.github.com/users/ljbade/events{/privacy}","received_events_url":"https://api.github.com/users/ljbade/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/mapbox/mapbox-gl-native/labels/Android","name":"Android","color":"5319e7"}],"state":"open","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/mapbox/mapbox-gl-native/milestones/11","html_url":"https://github.com/mapbox/mapbox-gl-native/milestones/android-v2.1.0","labels_url":"https://api.github.com/repos/mapbox/mapbox-gl-native/milestones/11/labels","id":1252366,"number":11,"title":"android-v2.1.0","description":"","creator":{"login":"bleege","id":989928,"avatar_url":"https://avatars.githubusercontent.com/u/989928?v=3","gravatar_id":"","url":"https://api.github.com/users/bleege","html_url":"https://github.com/bleege","followers_url":"https://api.github.com/users/bleege/followers","following_url":"https://api.github.com/users/bleege/following{/other_user}","gists_url":"https://api.github.com/users/bleege/gists{/gist_id}","starred_url":"https://api.github.com/users/bleege/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bleege/subscriptions","organizations_url":"https://api.github.com/users/bleege/orgs","repos_url":"https://api.github.com/users/bleege/repos","events_url":"https://api.github.com/users/bleege/events{/privacy}","received_events_url":"https://api.github.com/users/bleege/received_events","type":"User","site_admin":false},"open_issues":7,"closed_issues":54,"state":"open","created_at":"2015-08-12T19:07:24Z","updated_at":"2015-10-06T22:24:22Z","due_on":null,"closed_at":null},"comments":2,"created_at":"2015-10-06T22:24:22Z","updated_at":"2015-10-06T22:29:31Z","closed_at":null,"body":"As @bleege mentioned in #2002 the JavaDoc work was starting to creep scope to include fixing various problems with the API I was noticing.\r\n\r\nThis ticket will allow us to track this separately.\r\n\r\nThis includes areas such as:\r\n- annotations and `null` checks, int range checks (eg don't just pass on negative int when C++ expects unsigned ints)\r\n- functions/classes exposed as \"public\" that should remain private (eg the functions that were only exposed for InfoWindow to hook into) - #2538 plays a role in this\r\n- functions that don't follow a clear logical pattern (eg #2539)\r\n\r\nReleasing our first major version on Android means we want the \"existing\" feature set's API to be high quality if we stick to semver. If we can hit this in time for 2.1.0 then we will avoid the need to jump to 3.0.0 as our next release so we can fixup the API.\r\n\r\n@bleege @tobrun \r\n"},"comment":{"url":"https://api.github.com/repos/mapbox/mapbox-gl-native/issues/comments/146020415","html_url":"https://github.com/mapbox/mapbox-gl-native/issues/2545#issuecomment-146020415","issue_url":"https://api.github.com/repos/mapbox/mapbox-gl-native/issues/2545","id":146020415,"user":{"login":"ljbade","id":1215089,"avatar_url":"https://avatars.githubusercontent.com/u/1215089?v=3","gravatar_id":"","url":"https://api.github.com/users/ljbade","html_url":"https://github.com/ljbade","followers_url":"https://api.github.com/users/ljbade/followers","following_url":"https://api.github.com/users/ljbade/following{/other_user}","gists_url":"https://api.github.com/users/ljbade/gists{/gist_id}","starred_url":"https://api.github.com/users/ljbade/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ljbade/subscriptions","organizations_url":"https://api.github.com/users/ljbade/orgs","repos_url":"https://api.github.com/users/ljbade/repos","events_url":"https://api.github.com/users/ljbade/events{/privacy}","received_events_url":"https://api.github.com/users/ljbade/received_events","type":"User","site_admin":false},"created_at":"2015-10-06T22:29:31Z","updated_at":"2015-10-06T22:29:31Z","body":"I have also realised we should be more ruthless at removing dead/commented out code, and TODOs from master. We can always revive old code again easily thanks to git history."}}