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@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 ;-)


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:




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, 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 [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@lists.jboss.org
https://lists.jboss.org/mailman/listinfo/aerogear-dev


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

_______________________________________________
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


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