On 02/19/2015 05:44 AM, Lukáš Fryč wrote:
@Summers, I agree that we don't have to document whole process of
setting the environment up,
On that point JIRA created : AEROGEAR-1629
but the docs should at least guide users that are completely new to
the subject appropriately.
Use case: I haven't developed anything on native Android yet, and I
want to change that. I want to make that shift with AeroGear. But what
should I do? I know AeroGear, nothing else. Where should I go now to
get the basics AeroGear expects from me?
We don't exactly have a "know
AeroGear". This isn't like Cordova or
Titanium where you build an app targeting their runtime and package it
for a platform.
So First Steps guide can cover what are expectations from the user on
development environment side. It may just contain brief description of
prerequisites and few links where people may get more information.
Then adding in a
line "We expect you to know the basics of Android
development with Android Studio", including a link to Google's getting
started docs and having a section on what to add to the build.gradle
files with cross links to relevant user guides should be enough? That is
the goal of the JIRA issue at least right now.
It can also contain our preferred/opinionated way of Android
development, being it an IDE of our choice or whatever.
I'm guessing I
don't get to call Eclipse a miserable hell dimension from
which there is no escape one you enter? ;)
Where should the building guide go? (Will need to make another JIRA for
that)
On Wed, Feb 18, 2015 at 5:37 PM, Summers Pittman <supittma(a)redhat.com
<mailto:supittma@redhat.com>> wrote:
On 02/18/2015 10:14 AM, Lukáš Fryč wrote:
> Hey guys,
>
> the new site is in baking for a quite some time, but I believe
> the results are already shaping up. The Big Thanks go to Andres
> off course!
>
>
> I must say it is NOT COMPLETE yet, but I believe we can start
> receiving issues. Especially kind of "we need complete rework of
> this section" kind of issues ;-)
>
>
http://staging-aerogearsite.rhcloud.com/
>
> Please discuss bigger issues right here,
I need to make a JIRA to change the Android section of first
steps. There is no reason anyone should be compiling the Android
library. However part of that will include moving the how to
build the Android library docs. Where should those go? Also what
should replace it? Getting started with he Android libraries is
basically include the stuff you want in your build/pom and use it.
Also, I noticed the getting started docs for Cordova include a lot
of basic "what is cordova" flavored information. Should we really
be concerned on the project page with teaching people how to use
the platform?
> but file any smaller issues under appropriate place in the New
> Design Epic:
>
>
https://issues.jboss.org/browse/AEROGEAR-1546
>
>
>
> Few bigger issues I identified and that I will need a help with:
>
> 1. filling in Core and Security landing pages
> 2. Guides for First Steps are missing for some platforms (they
> don't have to be overwhelmingly verbose, but at least we should
> have some)
> 3. connected individual's blog to News page (powered by
>
planet.jboss.org <
http://planet.jboss.org>, more info on IRC)
>
>
>
>
> Few issues that we still need to tackle - I believe we can cover
> that with Andres, but help is always welcomed!
>
> 1. make News page work javascript-wide (filtering, etc) [me]
> 2. document how-to + style guide for drafting/posting new posts
> on
aerogear.org <
http://aerogear.org> [me]
> 2. style individual Guides
> 3. style individual Posts
> 4. HTML structure corrections (e.g. wrong use of HTML tags) [Andres]
> 5. grammar/typo corrections [Catherine offered help here]
>
>
> Some features I planned originally will slip from the first
> release, but the main priority now is get the New Site out!
>
> ETA: the site could be nearly production-ready end of this week.
>
>
> Cheers,
>
> ~ Lukas
>
>
> _______________________________________________
> aerogear-dev mailing list
> aerogear-dev(a)lists.jboss.org <mailto:aerogear-dev@lists.jboss.org>
>
https://lists.jboss.org/mailman/listinfo/aerogear-dev
--
Summers Pittman
>>Phone:404 941 4698 <tel:404%20941%204698>
>>Java is my crack.
_______________________________________________
aerogear-dev mailing list
aerogear-dev(a)lists.jboss.org <mailto:aerogear-dev@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
--
Summers Pittman
>Phone:404 941 4698
>Java is my crack.