<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Tue, Oct 15, 2013 at 11:19 AM, Corinne Krych <span dir="ltr"><<a href="mailto:corinnekrych@gmail.com" target="_blank">corinnekrych@gmail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">+1 on grouping related documentation.<br></blockquote><div><br></div><div style>+1 on grouping, that should be our first task. </div>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
One thing I noticed is that we are not always consistent on grouping.<br>
<br>
For user guides, we do grouping on features OTP (which include iOS/Android/JS) and then separate link for cordova<br>
BUT we also do grouping for other features on iOS/Android/JS<br>
<br>
Titles are different too: we say "AeroGear Android User Guide" (which really refer to Android Cookbook) whereas we have "AeroGear iOS API Cookbook"<br></blockquote><div><br></div><div style>+1 Consistency is king ! </div>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
"Getting started" definitiveny need to be per platform<br>
"User Guides", I think I like them also per platform.<br>
<br>
Overall you right Seb, a bit of documntation refactor won't hurt.<br>
<br>
++<br>
<span class="HOEnZb"><font color="#888888">Corinne<br>
</font></span><div class="HOEnZb"><div class="h5"><br>
On Oct 15, 2013, at 10:58 AM, Daniel Bevenius <<a href="mailto:daniel.bevenius@gmail.com">daniel.bevenius@gmail.com</a>> wrote:<br>
<br>
> +1<br>
><br>
><br>
> On 15 October 2013 10:56, Matthias Wessendorf <<a href="mailto:matzew@apache.org">matzew@apache.org</a>> wrote:<br>
> +1 good idea to plan some overhauls on there;<br>
><br>
> Perhaps also a little bit of grouping? E.g. all the things around Push - currently the list is very long :-)<br>
><br>
><br>
> On Tue, Oct 15, 2013 at 10:32 AM, Sebastien Blanc <<a href="mailto:scm.blanc@gmail.com">scm.blanc@gmail.com</a>> wrote:<br>
> Hi !<br>
> I aws looking at <a href="http://aerogear.org/docs/guides/" target="_blank">http://aerogear.org/docs/guides/</a> , it's great , there is a lot of info but IMO there is too much infos, especially the "Getting Started" section :<br>
><br>
> - We have some old documents not directly related to "core" Aerogear, like <a href="http://aerogear.org/docs/guides/HTML5RESTApps/" target="_blank">http://aerogear.org/docs/guides/HTML5RESTApps/</a><br>
> - We have some nice Tutorials that are at the end of the list which should be more visible<br>
> - Some images links are broken.<br>
><br>
><br>
> Before opening jiras/PR I just wanted to ping the community to ask for their opinions.<br>
><br>
><br>
> Seb<br>
><br>
><br>
><br>
> _______________________________________________<br>
> aerogear-dev mailing list<br>
> <a href="mailto:aerogear-dev@lists.jboss.org">aerogear-dev@lists.jboss.org</a><br>
> <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
><br>
><br>
><br>
> --<br>
> Matthias Wessendorf<br>
><br>
> blog: <a href="http://matthiaswessendorf.wordpress.com/" target="_blank">http://matthiaswessendorf.wordpress.com/</a><br>
> sessions: <a href="http://www.slideshare.net/mwessendorf" target="_blank">http://www.slideshare.net/mwessendorf</a><br>
> twitter: <a href="http://twitter.com/mwessendorf" target="_blank">http://twitter.com/mwessendorf</a><br>
><br>
> _______________________________________________<br>
> aerogear-dev mailing list<br>
> <a href="mailto:aerogear-dev@lists.jboss.org">aerogear-dev@lists.jboss.org</a><br>
> <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
><br>
> _______________________________________________<br>
> aerogear-dev mailing list<br>
> <a href="mailto:aerogear-dev@lists.jboss.org">aerogear-dev@lists.jboss.org</a><br>
> <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
<br>
<br>
_______________________________________________<br>
aerogear-dev mailing list<br>
<a href="mailto:aerogear-dev@lists.jboss.org">aerogear-dev@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
</div></div></blockquote></div><br></div></div>