Re: [aerogear-dev] AeroGear Android Root Document

Hello Daniel I really buy into your idea. We definitively need more consistent documentation on AeroGear features with concrete and simple exemple (like we started in cookbook). Let's refactor our documentation together and meake suure we go in the same direction. See Hylke thread on it [1]. As suggested by Hylke, let's group our documentation per category/features: core, push, security, offline/sync. We could have a general description of what the features is, some link to specs etc.. Then the sample part. Each sample/recipe(from cookbook) should be well documented and follow a similar template like you gist shown it. I've done similar with iOS-cookbook. One central readme [1] which list all recipes. Each recipes [2] has is own documentation following the same template. We ca work on unifying the template. I like prerequisites section, install/build section common to both, you miss a short description of the app and some ui flow with pictures would be nice and then a last sec ion we we explain the main fatures we want ot demo. A couple of questions on implementation though: - Instead of just having links to cookbook, how can we embed in asciidoc or markdown? the sample documentation should belong to the cookbook repo. - How are we going to publish read me info from cookbook into aerogear.org repo? a build or some sort of automation will be good. ++ Corinne [1] http://aerogear-dev.1069024.n5.nabble.com/aerogear-dev-Website-restructur... [1] https://github.com/corinnekrych/aerogear-ios-cookbook/blob/master/README.md [2] https://github.com/corinnekrych/aerogear-ios-cookbook/blob/master/Xmas/Xm... On Dec 9, 2013, at 11:20 PM, Daniel Passos <daniel(a)passos.me&gt; wrote: