{"action":"created","issue":{"url":"https://api.github.com/repos/Estimote/Android-SDK/issues/115","labels_url":"https://api.github.com/repos/Estimote/Android-SDK/issues/115/labels{/name}","comments_url":"https://api.github.com/repos/Estimote/Android-SDK/issues/115/comments","events_url":"https://api.github.com/repos/Estimote/Android-SDK/issues/115/events","html_url":"https://github.com/Estimote/Android-SDK/issues/115","id":94332850,"number":115,"title":"Please Provide Documentation for Android","user":{"login":"RingoMckraken","id":5691414,"avatar_url":"https://avatars.githubusercontent.com/u/5691414?v=3","gravatar_id":"","url":"https://api.github.com/users/RingoMckraken","html_url":"https://github.com/RingoMckraken","followers_url":"https://api.github.com/users/RingoMckraken/followers","following_url":"https://api.github.com/users/RingoMckraken/following{/other_user}","gists_url":"https://api.github.com/users/RingoMckraken/gists{/gist_id}","starred_url":"https://api.github.com/users/RingoMckraken/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/RingoMckraken/subscriptions","organizations_url":"https://api.github.com/users/RingoMckraken/orgs","repos_url":"https://api.github.com/users/RingoMckraken/repos","events_url":"https://api.github.com/users/RingoMckraken/events{/privacy}","received_events_url":"https://api.github.com/users/RingoMckraken/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-07-10T15:45:46Z","updated_at":"2015-07-14T01:54:01Z","closed_at":null,"body":"I get that your sdk is \"closed\" for whatever reasons deemed applicable, but at the very least can there be some detail documentation / tuts (that use modern android practices, Holo theme is 4 years old, you can do better than that.) like the iOS sdk has? After digging through the archive files and de-compiling the classes.jar file it becomes immediately apparent that the android support is an afterthought. \r\n\r\nOn your community portal there is mention that Estimote beacons can be monitored via the open source Android Beacon Library from Radius networks, yet there is very little information on how to set the beacons layout paremeter for monitoring.\r\n\r\nSorry for sounding like a complainer but a tech that is this pervasive and powerful needs support across the board, it can only bring more success to everyone at the end of the day."},"comment":{"url":"https://api.github.com/repos/Estimote/Android-SDK/issues/comments/121109688","html_url":"https://github.com/Estimote/Android-SDK/issues/115#issuecomment-121109688","issue_url":"https://api.github.com/repos/Estimote/Android-SDK/issues/115","id":121109688,"user":{"login":"RingoMckraken","id":5691414,"avatar_url":"https://avatars.githubusercontent.com/u/5691414?v=3","gravatar_id":"","url":"https://api.github.com/users/RingoMckraken","html_url":"https://github.com/RingoMckraken","followers_url":"https://api.github.com/users/RingoMckraken/followers","following_url":"https://api.github.com/users/RingoMckraken/following{/other_user}","gists_url":"https://api.github.com/users/RingoMckraken/gists{/gist_id}","starred_url":"https://api.github.com/users/RingoMckraken/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/RingoMckraken/subscriptions","organizations_url":"https://api.github.com/users/RingoMckraken/orgs","repos_url":"https://api.github.com/users/RingoMckraken/repos","events_url":"https://api.github.com/users/RingoMckraken/events{/privacy}","received_events_url":"https://api.github.com/users/RingoMckraken/received_events","type":"User","site_admin":false},"created_at":"2015-07-14T01:54:00Z","updated_at":"2015-07-14T01:54:00Z","body":"First I'd like to thank you for such a concise and friendly response. That speaks volumes for Estimote's commitment to the development community at large. Second I'd like to apologize for my tone in the issue raised on this repo, I'm a hardcore android guy in a world of iOS first so I definitely think we feel each other's pain on the need to uphold the standards and best practices of the platform(s) we have to support.\r\n\r\nTo further elaborate and address your questions, and this is something all android dev's (foot in mouth) struggle with, is the lightning pace that this tech evolves. I/O this year unleashed a plethora of updates and support libraries with much welcome to the community, although not completely encompassed in the native documentation, these practices continue to evolve to become the de-facto standard for \"how it's done\". The tools we use on a daily basis and the native sdk's we use are a direct reflection of that, constant updates that force developers to look around the corner to see what production code could be affected and what level of refactoring will have to take place to accommodate the changes for an ever diverse user base with differing hardware specs, os versions, custom OEM forks, etc. \r\n\r\nWhat I mean specifically by documentation is the on boarding experience itself. Say you are a code shop that has a handful of devs on both sides of the fence. This shop gets a BLE beacon related project for a critically acclaimed client. One side  gets a clean paint by numbers step by step (and I may just have a hard time finding these docs) guide on the meat and potatoes of integrating the tech into their production code(albeit proprietary), while the other gets a link to github repo a small readme, and is left to stack overflow / the web (not to say that's a bad thing, and yes that is a bit of a dramatic stretch). The one side get's their code written quick as wind and is off running to the races. Meanwhile, the other is backwards configuring their environment, build system, and \"the latest and greatest\" to make it work (on a platform where 45% of the target market won't even be able to use it,) and has to explain why they spent a little more time to get their code to work. This is the plight of a lot of developers out that and we are scrambling to just get it to work so we can implement application logic and fine tune the code to not crash on a myriad of devices.\r\n\r\nThank you again for responding and listening to the community. At the end of the day, I'd love to see a million giving constructive feedback and vice versa to help you guys and the community at large support every platform available in the market. Look at the competition and help us do that. We got your back and will support you.\r\n"}}