update:


UnifiedPush Server User Guide







On Thu, Jul 24, 2014 at 1:29 PM, Matthias Wessendorf <matzew@apache.org> wrote:
Here is the TOC that I have in mind (and started to work on):

UnifiedPush Server User Guide

  • Overview
    • About the UnifiedPush Server
    • Use-cases and scenarios
    • Useful Terminology
    • How the UnifiedPush Server Works
  • Installation and configuration
    • The WAR file distribution
      • setup and configure a database
      • deploy the WAR files
  • Running on OpenShift
    • create an instance using OpenShift's Web UI
    • create an instance using OpenShift's command line interface
  • Using the Admin UI
    • Administering the UnifiedPush Server Console
    • Configuring and Managing Applications that use the UnifiedPush Server
    • Preparing mobile devices to be connected with the UnifiedPush Server
    • Sending Push Notifications
  • Next steps
    • TBD: Links to tutorials and specs (some specs might go away)




On Thu, Jul 24, 2014 at 11:26 AM, Matthias Wessendorf <matzew@apache.org> wrote:
Before actually starting with the (initial) rewrite of the UPS guide (as I outlined), I did the re-org of the UPS content.

Please review: 




On Mon, Jul 21, 2014 at 5:59 PM, Matthias Wessendorf <matzew@apache.org> wrote:

Hi,

right now we have a lot of different 'documentation files', like the README, some specs, and guides and tutorials.

I'd like to restructure that a bit and centralize the documentation a bit.

On the "push" landing page ([1]), I'd like to change the "Lean More" link to a new page that has all the UPS centric documentations

  • AeroGear UnifiedPush Server User/Reference Guide
  • Tutorials

AeroGear UnifiedPush Server User/Reference Guide

  • Overview
    • some generic information
  • Installation and configuration
    • what's needed (e.g. JBoss and a database)
  • Running on OpenShift
    • using the UI on OpenShift
    • using the rhc command line
  • Using the Admin UI
    • doing an overhaul of our existing Admin UI guide (e.g. taking new screenshots and updating based on new UI features)

The format of the reference guide would be similar to the one from Keycloak ([2]). But... I will continue using asciidoc ;-)

The README will be extremely quick and simply link to the homepage ;-) After this new reference guide, I think some of the current specs can be removed, as the reference guide hopefully covers all of their content :-) 

For the RESTful APIs, I have to look what Keycloak did to get something like:http://docs.jboss.org/keycloak/docs/1.0-beta-3/rest-api/overview-index.html

After the work as been completed, I will be revisiting the specs and evaluate their need ;-)

Tutorials

This section will contain links to all the different tutorials we have:

For Cordova we will have one single document, instead of three:

There is already a JIRA for that ([4]).

To make it more clear (or clean?), I will remove the UPS/Push related docs from our guides ([3]) and replace all those links by a single link to the above mentioned new page (also referenced from [1]).

Greetings,
Matthias



--
Matthias Wessendorf

blog: http://matthiaswessendorf.wordpress.com/
sessions: http://www.slideshare.net/mwessendorf
twitter: http://twitter.com/mwessendorf



--
Matthias Wessendorf

blog: http://matthiaswessendorf.wordpress.com/
sessions: http://www.slideshare.net/mwessendorf
twitter: http://twitter.com/mwessendorf



--
Matthias Wessendorf

blog: http://matthiaswessendorf.wordpress.com/
sessions: http://www.slideshare.net/mwessendorf
twitter: http://twitter.com/mwessendorf



--
Matthias Wessendorf

blog: http://matthiaswessendorf.wordpress.com/
sessions: http://www.slideshare.net/mwessendorf
twitter: http://twitter.com/mwessendorf