Re: [aerogear-dev] iOS API Doc improvement

I am not sure; having the snippets on top of the functions where they belong too, makes sense; Having EVERYTHING at the begining of the file is, perhaps, nice for some folks too... I think I'd be +0.5 for the [4] -M On Thu, Mar 7, 2013 at 3:57 PM, Christos Vasilakis <cvasilak(a)gmail.com&gt; wrote: > Hi team, > > we are currently in the process of cleaning up and improving iOS documentation. For better visibility, we are integrating the API usage guide found here [1] inside (generated from code) API docs [2]. > > The question is where we should put the "example code". For this, there are two approaches, either collect and put them all in the header of the file with different sections[3] or inline with the function [4]. > > wdyt? > > - > Christos > > [1] https://github.com/aerogear/aerogear-ios/blob/master/API.md > [2] http://aerogear.org/docs/specs/aerogear-ios/ > [3] http://tinyurl.com/cdldzh9 > [4] http://tinyurl.com/cjhg5ke > > > > > _______________________________________________ > 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