+1On 03/20/2013 04:44 AM, Matthias Wessendorf wrote:
Howdy,
great to see some docs/guides
Here are my first/initial comments:
1) Group them into a subfolder, like daniel did, for the controller+1
2) links to the matching JavaDocs (classes (e.g. PipeHandlert etc)) does not hurtI disagree. It may be titled wrong, but knowing how the Android library implements Pipes and how to extend this implementations for your own end is quite useful.
3) not sure about if the `AerogearAndroidCustomizingPipes.asciidoc` is really useful ...
At least that is the goal of the doc, what did you see differently?Because the default implementation of Parameter Provider just consumes data provided by the PageConsumer. Explicitly setting it isn't necessary.
"AerogearAndroidPagination"4) You never show ParameterProvider...
The root of the data you want to operate on as explained in the Intro document and the API's.5) what is config.setDataRoot()
For example, in the DevNexus result set for speakers you have
{
speakers : {
data:[
{speaker1},
{speaker2}
]
}
}
The "list" of data you are asking for actually starts at the data parameter of the speakers parameter. config.setDataRoot("speakers.data"); makes this explicit.
No unless you are consuming it from a service where the paging doesn't follow "simple" patterns.
--> looks like the Android bits are a bit _different_, compared to the iOS/JS version6) do I really have to implement my own "PageResultExtractor"Because the simple read of pagination is linked to at the beginning for the doc. This is for consuming arbitrary paging from a site. Perhaps this needs to be an "advanced" doc and I should discuss simpler paging in an into doc. Like Pipes.
The Pagination feels: Lot's of code... for a simple read...
Seems like some of the docs might be missing things (an intro read to paging, more explicit goals of the guid etc).
-Matthias
On Tue, Mar 19, 2013 at 9:19 PM, Summers Pittman <supittma@redhat.com> wrote:
I just committed some guides for using the Aerogear Android libraries.
https://github.com/aerogear/aerogear.org/commit/d3cae265d
I'm still editing them for gramma/spelling/formatting, so be warned (hence why I havn't PRed it yet). Also, if there is anything I missed, glossed over, explained like crap let me know and I will try to reword it when I begin proofreading.
Summers
_______________________________________________
aerogear-dev mailing list
aerogear-dev@lists.jboss.org
https://lists.jboss.org/mailman/listinfo/aerogear-dev
--
Matthias Wessendorf
blog: http://matthiaswessendorf.wordpress.com/
sessions: http://www.slideshare.net/mwessendorf
twitter: http://twitter.com/mwessendorf
_______________________________________________ aerogear-dev mailing list aerogear-dev@lists.jboss.org https://lists.jboss.org/mailman/listinfo/aerogear-dev
_______________________________________________
aerogear-dev mailing list
aerogear-dev@lists.jboss.org
https://lists.jboss.org/mailman/listinfo/aerogear-dev