[aerogear-dev] Site review: general feedback

[Jay Balunas]

On Sep 19, 2012, at 4:27 AM, Matthias Wessendorf wrote:

> Howdy,
> 
> a few questions/suggestions on the site
> 
> * HOME page => iOS section
> - It says "Download Now (Coming Soon!)", however on CocoaPods we
> already have three releases, should we add a link here? Or do we wait
> on the DMG format (see [1])?
> - Include the github repo for the 'view source' link?

+1 to both, even if Alpha lets get it there

> 
> * Download section
> - Like above should we add a download link here? Or do we wait on the
> DMG format (see [1])?

I say don't wait

> 
> == Documentation ==
> * Specifications
> - Should we name this section 'API documentation'? Right now it is
> 'just' API docs - or do we provide 'specs' here in the future?
> => We could than also break it down into "Client API docs" (e.g.
> Android, JS,...) and "Server API docs" (e.g. aerogear-controller)

Ideally this is where we would have our defined server interface spec, client side API, AeroGear controller spec, etc...

It is just light on content while we're working on those bits.

> 
> - Should the link to AeroGear.js point to http://aerogear.github.com
> resource ? Or is it correct that it points to a 'self hosted' API doc
> ?
> (I guess at some point we need versioning - yes, we spoke about that
> in the past :) )
> 
> 
> * Contributing to AeroGear
> -> Is this link getting enough visibility ? :)
> 
> * Guides (Tutorials, gettings started docs, how-tos)
> 
> ==> I think we should do some 'grouping' here, folks that are
> interested in 'getting started', probably don't care that much about
> 'How to Handle AeroGear Pull Requests' or 'AeroGear GitHub Workflow'
> initially.... IMO looks a bit overloaded (unorganized)...
> 
> ===> Suggested groups for the "Tutorials, gettings started docs,
> how-tos" (sub)section:

+1

> 
> * Supported Platforms
> AeroGear Browser Support Targets
> 
> * Getting Started:
> Get Started With HTML5 Mobile Web Development
> Deploying HTML5 Applications to Openshift
> HTML5 Mobile Quickstart & Archetype Deep Dive
> HTML5 + REST Applications
> Cordova Setup
> Converting an AeroGear HTML5 + REST Web App to a Hybrid App with Apache Cordova
> Get Started with Hybrid Application Frameworks
> 
> * Contributing to AeroGear
> Contributing to AeroGear
> AeroGear GitHub Workflow
> How to Handle AeroGear Pull Requests
> AeroGear JIRA Usage and Guidelines
> AeroGear Licensing and Copyright
> 
> 
> Greetings,
> Matthias
> 
> [1] https://issues.jboss.org/browse/AEROGEAR-443
> 
> -- 
> Matthias Wessendorf
> 
> blog: http://matthiaswessendorf.wordpress.com/
> sessions: http://www.slideshare.net/mwessendorf
> twitter: http://twitter.com/mwessendorf
> _______________________________________________
> aerogear-dev mailing list
> aerogear-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/aerogear-dev