[aerogear-dev] New Site - Status

[Summers Pittman]

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 at redhat.com 
> <mailto:supittma at 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 at lists.jboss.org  <mailto:aerogear-dev at 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 at lists.jboss.org <mailto:aerogear-dev at lists.jboss.org>
>     https://lists.jboss.org/mailman/listinfo/aerogear-dev
>
>
>
>
> _______________________________________________
> aerogear-dev mailing list
> aerogear-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/aerogear-dev


-- 
Summers Pittman
>>Phone:404 941 4698
>>Java is my crack.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/aerogear-dev/attachments/20150219/79747870/attachment-0001.html