Re: [aerogear-dev] [iOS] Datamanager / AGStore

On Feb 25, 2013, at 7:21 AM, Matthias Wessendorf <matzew(a)apache.org&gt; wrote: On Mon, Feb 25, 2013 at 2:15 PM, Kris Borchers <kris(a)redhat.com&gt; wrote: > > On Feb 24, 2013, at 1:07 AM, Douglas Campos <qmx(a)qmx.me&gt; wrote: > > On Fri, Feb 22, 2013 at 11:25:33AM -0600, Kris Borchers wrote: > > At the same time, I am leery of leaving it in if iOS and Android don't > have something similar since this feature was not thoroughly > discussed. I would hate to leave this in, only to have to deprecate it > in a later release for something that we decide works better for all > libs. > > How do you feel about node.js stability indication on APIs? Perhaps we > could borrow some inspiration there (and this filter API would be > experimental then) > > > So I like this idea in theory. I have a couple of concerns. > > 1. We're talking about a specific method here which is a pretty > detailed place to mark something experimental. At the same time, I wouldn't > want to mark all of DataManager as experimental just because of one method. > > I agree, just that particular method :) 2) Related to #1, we would then have to go through and give a stability rating to every method of every piece of AeroGear and maintain that for every new feature, method, etc. 3) We would need to document our index somewhere similar to http://nodejs.org/api/documentation.html#documentation_stability_index that would be nice, but having a doc on that particular function/method could be fine, for now… My concern with doing that is then we haven't standardized a way to mark things as experimental and it could get out of hand quickly and messy to clean up later.

> > -- > qmx > _______________________________________________ > aerogear-dev mailing list > aerogear-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/aerogear-dev > > > > _______________________________________________ > aerogear-dev mailing list > aerogear-dev(a)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(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/aerogear-dev _______________________________________________ aerogear-dev mailing list aerogear-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/aerogear-dev