<div dir="ltr">Looks good!<div>perhaps change: <span style="color:rgb(80,0,80);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px">Configuring and Managing Applications that use the UnifiedPush Server -> </span><span style="color:rgb(80,0,80);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px">Configuring and managing applications that use the UnifiedPush Server</span></div>
<div><span style="color:rgb(80,0,80);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px"><br></span></div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On 24 July 2014 13:32, Matthias Wessendorf <span dir="ltr"><<a href="mailto:matzew@apache.org" target="_blank">matzew@apache.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">update:<div><br></div><div><br></div><div><h1 style="font-size:2.5em;margin-right:0px;margin-bottom:15px;margin-left:0px;line-height:1.7;padding:0px;border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(221,221,221);color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;margin-top:0px!important">
UnifiedPush Server User Guide</h1><ul style="padding:0px 0px 0px 30px;margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px"><div class=""><li>Overview<ul style="padding:0px 0px 0px 30px;margin:0px">
<li>About the UnifiedPush Server</li><li>Use-cases and scenarios</li><li>Useful Terminology</li><li>How the UnifiedPush Server Works</li></ul></li><li>Installation and configuration<ul style="padding:0px 0px 0px 30px;margin:0px">
<li>The WAR file distribution<ul style="padding:0px 0px 0px 30px;margin:0px"><li>setup and configure a database</li><li>deploy the WAR files</li></ul></li></ul></li><li>Running on OpenShift<ul style="padding:0px 0px 0px 30px;margin:0px">
<li>create an instance using OpenShift's Web UI</li><li>create an instance using OpenShift's command line interface</li></ul></li></div><li>Using the Admin UI<ul style="padding:0px 0px 0px 30px;margin:0px"><div class="">
<li>
Administering the UnifiedPush Server Console</li><li>Configuring and Managing Applications that use the UnifiedPush Server</li><li>Preparing mobile devices to be connected with the UnifiedPush Server</li><li>Sending Push Notifications</li>
</div><li>Preparing backends to send Push Notifications</li></ul></li><div class=""><li>Next steps</li><ul style="padding:0px 0px 0px 30px;margin:0px"><li>TBD: Links to tutorials and specs (some specs might go away)</li>
</ul></div></ul><div>
<font color="#333333" face="Helvetica, arial, freesans, clean, sans-serif"><span style="font-size:15px;line-height:25.5px"><br></span></font></div></div><div><font color="#333333" face="Helvetica, arial, freesans, clean, sans-serif"><span style="font-size:15px;line-height:25.5px"><br>
</span></font></div><div><font color="#333333" face="Helvetica, arial, freesans, clean, sans-serif"><span style="font-size:15px;line-height:25.5px"><br></span></font></div><div><font color="#333333" face="Helvetica, arial, freesans, clean, sans-serif"><span style="font-size:15px;line-height:25.5px"><br>
</span></font></div></div><div class="HOEnZb"><div class="h5"><div class="gmail_extra"><br><br><div class="gmail_quote">On Thu, Jul 24, 2014 at 1:29 PM, Matthias Wessendorf <span dir="ltr"><<a href="mailto:matzew@apache.org" target="_blank">matzew@apache.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Here is the TOC that I have in mind (and started to work on):<div><br></div><div><h1 style="font-size:2.5em;margin-right:0px;margin-bottom:15px;margin-left:0px;line-height:1.7;padding:0px;border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(221,221,221);color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;margin-top:0px!important">
UnifiedPush Server User Guide</h1><ul style="padding:0px 0px 0px 30px;margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px"><li>Overview<ul style="padding:0px 0px 0px 30px;margin:0px">
<li>About the UnifiedPush Server</li><li>Use-cases and scenarios</li><li>Useful Terminology</li><li>How the UnifiedPush Server Works</li></ul></li><li>Installation and configuration<ul style="padding:0px 0px 0px 30px;margin:0px">
<li>The WAR file distribution<ul style="padding:0px 0px 0px 30px;margin:0px"><li>setup and configure a database</li><li>deploy the WAR files</li></ul></li></ul></li><li>Running on OpenShift<ul style="padding:0px 0px 0px 30px;margin:0px">
<li>create an instance using OpenShift's Web UI</li><li>create an instance using OpenShift's command line interface</li></ul></li><li>Using the Admin UI<ul style="padding:0px 0px 0px 30px;margin:0px"><li>
Administering the UnifiedPush Server Console</li><div><li>Configuring and Managing Applications that use the UnifiedPush Server</li></div><li>Preparing mobile devices to be connected with the UnifiedPush Server</li>
<li>Sending Push Notifications</li>
</ul></li><li>Next steps</li><ul style="padding:0px 0px 0px 30px;margin:0px"><li>TBD: Links to tutorials and specs (some specs might go away)</li></ul></ul><div><font color="#333333" face="Helvetica, arial, freesans, clean, sans-serif"><span style="font-size:15px;line-height:25.5px"><br>
</span></font></div></div><div><font color="#333333" face="Helvetica, arial, freesans, clean, sans-serif"><span style="font-size:15px;line-height:25.5px"><br></span></font></div></div><div><div>
<div class="gmail_extra"><br><br><div class="gmail_quote">
On Thu, Jul 24, 2014 at 11:26 AM, Matthias Wessendorf <span dir="ltr"><<a href="mailto:matzew@apache.org" target="_blank">matzew@apache.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="ltr">Before actually starting with the (initial) rewrite of the UPS guide (as I outlined), I did the re-org of the UPS content.<div><br></div><div>Please review: </div><div><a href="https://github.com/aerogear/aerogear.org/pull/327" target="_blank">https://github.com/aerogear/aerogear.org/pull/327</a><br>
</div><div><br></div><div><br></div></div><div><div><div class="gmail_extra"><br><br><div class="gmail_quote">On Mon, Jul 21, 2014 at 5:59 PM, Matthias Wessendorf <span dir="ltr"><<a href="mailto:matzew@apache.org" target="_blank">matzew@apache.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><p style="margin-right:0px;margin-bottom:15px;margin-left:0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px;margin-top:0px!important">
Hi,</p><p style="margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px">
right now we have a lot of different 'documentation files', like the README, some specs, and guides and tutorials.</p><p style="margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px">
I'd like to restructure that a bit and centralize the documentation a bit.</p><p style="margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px">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</p>
<ul style="padding:0px 0px 0px 30px;margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px"><li>AeroGear UnifiedPush Server User/Reference Guide</li>
<li>Tutorials</li></ul><h2 style="margin:1em 0px 15px;line-height:1.7;font-size:2em;padding:0px;border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(238,238,238);color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif">
<a name="147682559dc5edc5_1476821d1093781f_14767b1258c0fa83_14759a6554618f0f_user-content-aerogear-unifiedpush-server-userreference-guide" href="https://gist.github.com/matzew/333f101b036336d96891#aerogear-unifiedpush-server-userreference-guide" rel="noreferrer" style="color:rgb(65,131,196);text-decoration:none;display:block;padding-right:6px;padding-left:30px" target="_blank"></a>AeroGear UnifiedPush Server User/Reference Guide</h2>
<ul style="padding:0px 0px 0px 30px;margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px"><li>Overview<ul style="padding:0px 0px 0px 30px;margin:0px">
<li>some generic information</li></ul></li><li>Installation and configuration<ul style="padding:0px 0px 0px 30px;margin:0px"><li>what's needed (e.g. JBoss and a database)</li></ul></li><li>Running on OpenShift<ul style="padding:0px 0px 0px 30px;margin:0px">
<li>using the UI on OpenShift</li><li>using the rhc command line</li></ul></li><li>Using the Admin UI<ul style="padding:0px 0px 0px 30px;margin:0px"><li>doing an overhaul of our existing Admin UI guide (e.g. taking new screenshots and updating based on new UI features)</li>
</ul></li></ul><p style="margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px">The format of the <em>reference guide</em> would be similar to the one from Keycloak ([2]). But... I will continue using asciidoc ;-)</p>
<p style="margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px">The README will be extremely quick and simply link to the homepage ;-) After this <em>new</em> reference guide, I think some of the current specs can be removed, as the <em>reference guide</em> hopefully covers all of their content :-) </p>
<p style="margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px">For the RESTful APIs, I have to look what Keycloak did to get something like:<a href="http://docs.jboss.org/keycloak/docs/1.0-beta-3/rest-api/overview-index.html" rel="noreferrer" style="color:rgb(65,131,196);text-decoration:none" target="_blank">http://docs.jboss.org/keycloak/docs/1.0-beta-3/rest-api/overview-index.html</a></p>
<p style="margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px">After the work as been completed, I will be revisiting the specs and evaluate their need ;-)</p>
<h2 style="margin:1em 0px 15px;line-height:1.7;font-size:2em;padding:0px;border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(238,238,238);color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif">
<a name="147682559dc5edc5_1476821d1093781f_14767b1258c0fa83_14759a6554618f0f_user-content-tutorials" href="https://gist.github.com/matzew/333f101b036336d96891#tutorials" rel="noreferrer" style="color:rgb(65,131,196);text-decoration:none;display:block;padding-right:6px;padding-left:30px" target="_blank"></a>Tutorials</h2>
<p style="margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px">This section will contain links to all the different tutorials we have:</p><ul style="padding:0px 0px 0px 30px;margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px">
<li><a href="http://aerogear.org/docs/guides/aerogear-push-ios/" rel="noreferrer" style="color:rgb(65,131,196);text-decoration:none" target="_blank">http://aerogear.org/docs/guides/aerogear-push-ios/</a></li><li><a href="http://aerogear.org/docs/guides/aerogear-push-js/" rel="noreferrer" style="color:rgb(65,131,196);text-decoration:none" target="_blank">http://aerogear.org/docs/guides/aerogear-push-js/</a></li>
<li><a href="http://aerogear.org/docs/guides/aerogear-push-android/" rel="noreferrer" style="color:rgb(65,131,196);text-decoration:none" target="_blank">http://aerogear.org/docs/guides/aerogear-push-android/</a></li><li>
<a href="http://aerogear.org/docs/guides/aerogear-push-chrome/" rel="noreferrer" style="color:rgb(65,131,196);text-decoration:none" target="_blank">http://aerogear.org/docs/guides/aerogear-push-chrome/</a></li>
<li><a href="http://aerogear.org/docs/guides/GetStartedwithJavaSender/" rel="noreferrer" style="color:rgb(65,131,196);text-decoration:none" target="_blank">http://aerogear.org/docs/guides/GetStartedwithJavaSender/</a></li>
</ul><p style="margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px">
For Cordova we will have one single document, instead of three:</p><ul style="padding:0px 0px 0px 30px;margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px">
<li><a href="http://aerogear.org/docs/guides/aerogear-push-cordova-android/" rel="noreferrer" style="color:rgb(65,131,196);text-decoration:none" target="_blank">http://aerogear.org/docs/guides/aerogear-push-cordova-android/</a></li>
<li><a href="http://aerogear.org/docs/guides/aerogear-push-cordova-ios/" rel="noreferrer" style="color:rgb(65,131,196);text-decoration:none" target="_blank">http://aerogear.org/docs/guides/aerogear-push-cordova-ios/</a></li>
<li><a href="http://aerogear.org/docs/guides/aerogear-cordova/AerogearCordovaPush/" rel="noreferrer" style="color:rgb(65,131,196);text-decoration:none" target="_blank">http://aerogear.org/docs/guides/aerogear-cordova/AerogearCordovaPush/</a></li>
</ul><p style="margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px">There is already a JIRA for that ([4]).</p><p style="margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px">
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]).</p><p style="margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px">
Greetings,<br>Matthias</p><p style="margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px"><br></p><ul style="padding:0px 0px 0px 30px;margin:15px 0px;color:rgb(51,51,51);font-family:Helvetica,arial,freesans,clean,sans-serif;font-size:15px;line-height:25.5px">
<li>[1] <a href="http://aerogear.org/push/" rel="noreferrer" style="color:rgb(65,131,196);text-decoration:none" target="_blank">http://aerogear.org/push/</a></li><li>[2] <a href="http://docs.jboss.org/keycloak/docs/1.0-beta-3/userguide/html/index.html" rel="noreferrer" style="color:rgb(65,131,196);text-decoration:none" target="_blank">http://docs.jboss.org/keycloak/docs/1.0-beta-3/userguide/html/index.html</a></li>
<li>[3] <a href="http://aerogear.org/docs/guides/" rel="noreferrer" style="color:rgb(65,131,196);text-decoration:none" target="_blank">http://aerogear.org/docs/guides/</a></li><li>[4] <a href="https://issues.jboss.org/browse/AGPUSH-805" rel="noreferrer" style="color:rgb(65,131,196);text-decoration:none" target="_blank">https://issues.jboss.org/browse/AGPUSH-805</a></li>
<span><font color="#888888">
</font></span></ul><span><font color="#888888"><div><br></div>-- <br>Matthias Wessendorf <br><br>blog: <a href="http://matthiaswessendorf.wordpress.com/" target="_blank">http://matthiaswessendorf.wordpress.com/</a><br>
sessions: <a href="http://www.slideshare.net/mwessendorf" target="_blank">http://www.slideshare.net/mwessendorf</a><br>
twitter: <a href="http://twitter.com/mwessendorf" target="_blank">http://twitter.com/mwessendorf</a>
</font></span></div>
</blockquote></div><br><br clear="all"><div><br></div>-- <br>Matthias Wessendorf <br><br>blog: <a href="http://matthiaswessendorf.wordpress.com/" target="_blank">http://matthiaswessendorf.wordpress.com/</a><br>sessions: <a href="http://www.slideshare.net/mwessendorf" target="_blank">http://www.slideshare.net/mwessendorf</a><br>
twitter: <a href="http://twitter.com/mwessendorf" target="_blank">http://twitter.com/mwessendorf</a>
</div>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br>Matthias Wessendorf <br><br>blog: <a href="http://matthiaswessendorf.wordpress.com/" target="_blank">http://matthiaswessendorf.wordpress.com/</a><br>
sessions: <a href="http://www.slideshare.net/mwessendorf" target="_blank">http://www.slideshare.net/mwessendorf</a><br>twitter: <a href="http://twitter.com/mwessendorf" target="_blank">http://twitter.com/mwessendorf</a>
</div>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br>Matthias Wessendorf <br><br>blog: <a href="http://matthiaswessendorf.wordpress.com/" target="_blank">http://matthiaswessendorf.wordpress.com/</a><br>
sessions: <a href="http://www.slideshare.net/mwessendorf" target="_blank">http://www.slideshare.net/mwessendorf</a><br>twitter: <a href="http://twitter.com/mwessendorf" target="_blank">http://twitter.com/mwessendorf</a>
</div>
</div></div><br>_______________________________________________<br>
aerogear-dev mailing list<br>
<a href="mailto:aerogear-dev@lists.jboss.org">aerogear-dev@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br></blockquote></div><br></div>