Re: [aerogear-dev] Cleaning up the guide section of aerogear.org
+1 on grouping related documentation.
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"
"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(a)gmail.com> wrote:
+1
On 15 October 2013 10:56, Matthias Wessendorf <matzew(a)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(a)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(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