On Tue, Oct 15, 2013 at 11:19 AM, Corinne Krych <corinnekrych@gmail.com> wrote:
+1 on grouping related documentation.

+1 on grouping, that should be our first task. 

One thing I noticed is that we are not always consistent on grouping.

For user guides, we do grouping on features OTP (which include iOS/Android/JS) and then separate link for cordova
BUT we also do grouping for other features on iOS/Android/JS

Titles are different too: we say "AeroGear Android User Guide" (which really refer to Android Cookbook) whereas we have "AeroGear iOS API Cookbook"

+1 Consistency is king !  

"Getting started" definitiveny need to be per platform
"User Guides", I think I like them also per platform.

Overall you right Seb, a bit of documntation refactor won't hurt.

++
Corinne

On Oct 15, 2013, at 10:58 AM, Daniel Bevenius <daniel.bevenius@gmail.com> wrote:

> +1
>
>
> On 15 October 2013 10:56, Matthias Wessendorf <matzew@apache.org> wrote:
> +1 good idea to plan some overhauls on there;
>
> Perhaps also a little bit of grouping? E.g. all the things around Push - currently the list is very long :-)
>
>
> On Tue, Oct 15, 2013 at 10:32 AM, Sebastien Blanc <scm.blanc@gmail.com> wrote:
> Hi !
> I aws looking at http://aerogear.org/docs/guides/ , it's great , there is a lot of info but IMO there is too much infos, especially the "Getting Started" section :
>
> - We have some old documents not directly related to "core" Aerogear, like http://aerogear.org/docs/guides/HTML5RESTApps/
> - We have some nice Tutorials that are at the end of the list which should be more visible
> - Some images links are broken.
>
>
> Before opening jiras/PR I just wanted to ping the community to ask for their opinions.
>
>
> Seb
>
>
>
> _______________________________________________
> 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


_______________________________________________
aerogear-dev mailing list
aerogear-dev@lists.jboss.org
https://lists.jboss.org/mailman/listinfo/aerogear-dev