rhoconnect 3.0.0.beta1

data/doc/migration.txt

@@ -0,0 +1,182 @@
+Migrating RhoSync application to RhoConnect
+===
+
+The best way of migrating your Rhosync app to Rhoconnect is to re-generate the application skeleton
+using Rhoconnect, then integrate all of your implementation specifics into it.
+However, if you prefer to migrate your Rhosync app manually, perform the steps in this document:
+
+## Install the Bundler
+Install the `bundler` gem:
+
+	:::term
+	$ [sudo] gem install bundler
+
+## Create the Gemfile
+Create a new `Gemfile` file in your application directory with the following content:
+
+	:::ruby
+	source 'http://rubygems.org'
+
+	gem 'rhoconnect', '3.0.0'
+
+	group :development do
+	  # By default to run application thin web server is used
+	  gem 'thin', '1.2.11', :platforms => :ruby
+
+	  # For jruby trinidad JRuby web server is used
+	  gem 'trinidad',  :platforms => :jruby
+	  # Alternative for jruby
+	  # gem 'jetty-rackup',  :platforms => :jruby
+	end
+
+	group :test do
+	  gem 'rack-test', '>= 0.5.3', :require => "rack/test"
+	  gem 'rspec', '~> 2.6.0'
+	  gem 'rcov', '>= 0.9.8'
+	end
+
+## Edit the Rakefile
+
+Adjust the existing `Rakefile` by changing `rhosync` to `rhoconnect`.
+
+Change this:
+	
+	:::ruby
+	begin
+	  require 'vendor/rhosync/lib/rhosync/tasks'
+	  require 'vendor/rhosync/lib/rhosync'
+	rescue LoadError
+	  require 'rhosync/tasks'
+	  require 'rhosync'
+	end
+	
+to this:
+
+	:::ruby
+	begin
+	  require 'vendor/rhoconnect/lib/rhoconnect/tasks'
+	  require 'vendor/rhoconnect/lib/rhoconnect'
+	rescue LoadError
+	  require 'rhoconnect/tasks'
+	  require 'rhoconnect'
+	end
+
+## Edit config.ru
+
+Adjust `config.ru` file by performing the following steps:
+
+1) Change the section shown below to replace `rhosync` with `rhoconnect`.
+
+Change this:
+
+	:::ruby
+	begin
+	  require 'vendor/rhosync/lib/rhosync/tasks'
+	  require 'vendor/rhosync/lib/rhosync'
+	rescue LoadError
+	  require 'rhosync/tasks'
+	  require 'rhosync'
+	end
+
+to this:
+
+	:::ruby
+	begin
+	  require 'vendor/rhoconnect/lib/rhoconnect/tasks'
+	  require 'vendor/rhoconnect/lib/rhoconnect'
+	rescue LoadError
+	  require 'rhoconnect/tasks'
+	  require 'rhoconnect'
+	end
+
+2) Change all `Rhosync` references to `Rhoconnect`.
+
+For example, change this:
+
+	:::ruby
+	Rhosync::Server.disable :run
+	
+to this:
+
+	:::ruby
+	Rhoconnect::Server.disable :run
+	
+## Edit application.rb
+
+Adjust `application.rb` file with the following steps:
+
+1) Change the name of the base class from:
+
+	:::ruby
+	class Application < Rhosync::Base
+	
+to:
+
+	:::ruby
+	class Application < Rhoconnect::Base
+
+## Edit spec/spec_helper.rb
+
+Edit your `spec/spec_helper.rb` file to contain the following:
+
+	:::ruby
+	require 'rubygems'
+
+	# Set environment to test
+	ENV['RHO_ENV'] = 'test'
+	ROOT_PATH = File.expand_path(File.join(File.dirname(__FILE__),'..'))
+	Bundler.require(:default, ENV['RHO_ENV'].to_sym)
+
+	# Try to load vendor-ed rhoconnect, otherwise load the gem
+	begin
+	  require 'vendor/rhoconnect/lib/rhoconnect'
+	rescue LoadError
+	  require 'rhoconnect'
+	end
+
+	# Load our rhoconnect application
+	require './application'
+	include Rhoconnect
+
+	require 'rhoconnect/test_methods'
+
+	module RSpec
+	  module Core
+	    module SharedExampleGroup
+	    private
+	      def ensure_shared_example_group_name_not_taken(name)
+	      end
+	    end
+	  end
+	end
+
+	shared_examples_for "SpecHelper" do
+	  include Rhoconnect::TestMethods
+  
+	  before(:each) do
+	    Store.db.flushdb
+	    Application.initializer(ROOT_PATH)
+	  end  
+	end
+
+## Edit spec files
+all of your spec files should be modified from:
+
+	:::ruby
+	describe "<SampleSpec>" do
+  		it_should_behave_like "SpecHelper"
+		...
+	end
+
+to:
+	
+	:::ruby
+	describe "<SampleSpec>" do
+  		it_should_behave_like "SpecHelper" do
+			...
+		end
+	end
+	
+## Edit implementation files
+Modify all of your application implementation files by changing the `Rhosync` references
+to `Rhoconnect`.

data/doc/public/css/print.css

@@ -0,0 +1,29 @@
+/* -----------------------------------------------------------------------
+
+
+ Blueprint CSS Framework 0.9
+ http://blueprintcss.org
+
+   * Copyright (c) 2007-Present. See LICENSE for more info.
+   * See README for instructions on how to use Blueprint.
+   * For credits and origins, see AUTHORS.
+   * This is a compressed file. See the sources in the 'src' directory.
+
+----------------------------------------------------------------------- */
+
+/* print.css */
+body {line-height:1.5;font-family:"Helvetica Neue", Arial, Helvetica, sans-serif;color:#000;background:none;font-size:10pt;}
+.container {background:none;}
+hr {background:#ccc;color:#ccc;width:100%;height:2px;margin:2em 0;padding:0;border:none;}
+hr.space {background:#fff;color:#fff;visibility:hidden;}
+h1, h2, h3, h4, h5, h6 {font-family:"Helvetica Neue", Arial, "Lucida Grande", sans-serif;}
+code {font:.9em "Courier New", Monaco, Courier, monospace;}
+a img {border:none;}
+p img.top {margin-top:0;}
+blockquote {margin:1.5em;padding:1em;font-style:italic;font-size:.9em;}
+.small {font-size:.9em;}
+.large {font-size:1.1em;}
+.quiet {color:#999;}
+.hide {display:none;}
+a:link, a:visited {background:transparent;font-weight:700;text-decoration:underline;}
+a:link:after, a:visited:after {content:" (" attr(href) ")";font-size:90%;}

data/doc/public/css/screen.css

@@ -0,0 +1,257 @@
+/* -----------------------------------------------------------------------
+
+
+ Blueprint CSS Framework 0.9
+ http://blueprintcss.org
+
+   * Copyright (c) 2007-Present. See LICENSE for more info.
+   * See README for instructions on how to use Blueprint.
+   * For credits and origins, see AUTHORS.
+   * This is a compressed file. See the sources in the 'src' directory.
+
+----------------------------------------------------------------------- */
+
+/* reset.css */
+html, body, div, span, object, iframe, h1, h2, h3, h4, h5, h6, p, blockquote, pre, a, abbr, acronym, address, code, del, dfn, em, img, q, dl, dt, dd, ol, ul, li, fieldset, form, label, legend, table, caption, tbody, tfoot, thead, tr, th, td {margin:0;padding:0;border:0;font-weight:inherit;font-style:inherit;font-size:100%;font-family:inherit;vertical-align:baseline;}
+body {line-height:1.5;}
+table {border-collapse:separate;border-spacing:0;}
+caption, th, td {text-align:left;font-weight:normal;}
+table, td, th {vertical-align:middle;}
+blockquote:before, blockquote:after, q:before, q:after {content:"";}
+blockquote, q {quotes:"" "";}
+a img {border:none;}
+
+/* typography.css */
+html {font-size:100.01%;}
+body {font-size:75%;color:#222;background:#fff;font-family:"Helvetica Neue", Arial, Helvetica, sans-serif;}
+h1, h2, h3, h4, h5, h6 {font-weight:normal;color:#111;}
+h1 {font-size:3em;line-height:1;margin-bottom:0.5em;}
+h2 {font-size:2em;margin-bottom:0.75em;}
+h3 {font-size:1.5em;line-height:1;margin-bottom:1em;}
+h4 {font-size:1.2em;line-height:1.25;margin-bottom:1.25em;}
+h5 {font-size:1em;font-weight:bold;margin-bottom:1.5em;}
+h6 {font-size:1em;font-weight:bold;}
+h1 img, h2 img, h3 img, h4 img, h5 img, h6 img {margin:0;}
+p {margin:0 0 1.5em;}
+p img.left {float:left;margin:1.5em 1.5em 1.5em 0;padding:0;}
+p img.right {float:right;margin:1.5em 0 1.5em 1.5em;}
+a:focus, a:hover {color:#000;}
+a {color:#009;text-decoration:underline;}
+blockquote {margin:1.5em;color:#666;font-style:italic;}
+strong {font-weight:bold;}
+em, dfn {font-style:italic;}
+dfn {font-weight:bold;}
+sup, sub {line-height:0;}
+abbr, acronym {border-bottom:1px dotted #666;}
+address {margin:0 0 1.5em;font-style:italic;}
+del {color:#666;}
+pre {margin:1.5em 0;white-space:pre;}
+pre, code, tt {font:1em 'andale mono', 'lucida console', monospace;line-height:1.5;}
+li ul, li ol {margin:0;}
+ul, ol {margin:0 1.5em 1.5em 0;padding-left:3.333em;}
+ul {list-style-type:disc;}
+ol {list-style-type:decimal;}
+dl {margin:0 0 1.5em 0;}
+dl dt {font-weight:bold;}
+dd {margin-left:1.5em;}
+table {table-layout: fixed; margin-bottom:1.4em;width:100%;}
+th {font-weight:bold;}
+thead th {background:#c3d9ff;}
+th, td, caption {padding:1px 4px 1px 2px;}
+tr.even td {background:#e5ecf9;}
+tfoot {font-style:italic;}
+caption {background:#eee;}
+.small {font-size:.8em;margin-bottom:1.875em;line-height:1.875em;}
+.large {font-size:1.2em;line-height:2.5em;margin-bottom:1.25em;}
+.hide {display:none;}
+.quiet {color:#666;}
+.loud {color:#000;}
+.highlight {background:#ff0;}
+.added {background:#060;color:#fff;}
+.removed {background:#900;color:#fff;}
+.first {margin-left:0;padding-left:0;}
+.last {margin-right:0;padding-right:0;}
+.top {margin-top:0;padding-top:0;}
+.bottom {margin-bottom:0;padding-bottom:0;}
+
+/* forms.css */
+label {font-weight:bold;}
+fieldset {padding:1.4em;margin:0 0 1.5em 0;border:1px solid #ccc;}
+legend {font-weight:bold;font-size:1.2em;}
+input[type=text], input[type=password], input.text, input.title, textarea, select {background-color:#fff;border:1px solid #bbb;}
+input[type=text]:focus, input[type=password]:focus, input.text:focus, input.title:focus, textarea:focus, select:focus {border-color:#666;}
+input[type=text], input[type=password], input.text, input.title, textarea, select {margin:0.5em 0;}
+input.text, input.title {width:300px;padding:5px;}
+input.title {font-size:1.5em;}
+textarea {width:390px;height:250px;padding:5px;}
+input[type=checkbox], input[type=radio], input.checkbox, input.radio {position:relative;top:.25em;}
+form.inline {line-height:3;}
+form.inline p {margin-bottom:0;}
+.error, .notice, .success {padding:.8em;margin-bottom:1em;border:2px solid #ddd;}
+.error {background:#FBE3E4;color:#8a1f11;border-color:#FBC2C4;}
+.notice {background:#FFF6BF;color:#514721;border-color:#FFD324;}
+.success {background:#E6EFC2;color:#264409;border-color:#C6D880;}
+.error a {color:#8a1f11;}
+.notice a {color:#514721;}
+.success a {color:#264409;}
+
+/* grid.css */
+.container {width:950px;margin:0 auto;}
+.showgrid {background:url(src/grid.png);}
+.column, div.span-1, div.span-2, div.span-3, div.span-4, div.span-5, div.span-6, div.span-7, div.span-8, div.span-9, div.span-10, div.span-11, div.span-12, div.span-13, div.span-14, div.span-15, div.span-16, div.span-17, div.span-18, div.span-19, div.span-20, div.span-21, div.span-22, div.span-23, div.span-24 {float:left;margin-right:10px;}
+.last, div.last {margin-right:0;}
+.span-1 {width:30px;}
+.span-2 {width:70px;}
+.span-3 {width:110px;}
+.span-4 {width:150px;}
+.span-5 {width:190px;}
+.span-6 {width:230px;}
+.span-7 {width:270px;}
+.span-8 {width:310px;}
+.span-9 {width:350px;}
+.span-10 {width:390px;}
+.span-11 {width:430px;}
+.span-12 {width:470px;}
+.span-13 {width:510px;}
+.span-14 {width:550px;}
+.span-15 {width:590px;}
+.span-16 {width:630px;}
+.span-17 {width:670px;}
+.span-18 {width:710px;}
+.span-19 {width:750px;}
+.span-20 {width:790px;}
+.span-21 {width:830px;}
+.span-22 {width:870px;}
+.span-23 {width:910px;}
+.span-24, div.span-24 {width:950px;margin-right:0;}
+input.span-1, textarea.span-1, input.span-2, textarea.span-2, input.span-3, textarea.span-3, input.span-4, textarea.span-4, input.span-5, textarea.span-5, input.span-6, textarea.span-6, input.span-7, textarea.span-7, input.span-8, textarea.span-8, input.span-9, textarea.span-9, input.span-10, textarea.span-10, input.span-11, textarea.span-11, input.span-12, textarea.span-12, input.span-13, textarea.span-13, input.span-14, textarea.span-14, input.span-15, textarea.span-15, input.span-16, textarea.span-16, input.span-17, textarea.span-17, input.span-18, textarea.span-18, input.span-19, textarea.span-19, input.span-20, textarea.span-20, input.span-21, textarea.span-21, input.span-22, textarea.span-22, input.span-23, textarea.span-23, input.span-24, textarea.span-24 {border-left-width:1px!important;border-right-width:1px!important;padding-left:5px!important;padding-right:5px!important;}
+input.span-1, textarea.span-1 {width:18px!important;}
+input.span-2, textarea.span-2 {width:58px!important;}
+input.span-3, textarea.span-3 {width:98px!important;}
+input.span-4, textarea.span-4 {width:138px!important;}
+input.span-5, textarea.span-5 {width:178px!important;}
+input.span-6, textarea.span-6 {width:218px!important;}
+input.span-7, textarea.span-7 {width:258px!important;}
+input.span-8, textarea.span-8 {width:298px!important;}
+input.span-9, textarea.span-9 {width:338px!important;}
+input.span-10, textarea.span-10 {width:378px!important;}
+input.span-11, textarea.span-11 {width:418px!important;}
+input.span-12, textarea.span-12 {width:458px!important;}
+input.span-13, textarea.span-13 {width:498px!important;}
+input.span-14, textarea.span-14 {width:538px!important;}
+input.span-15, textarea.span-15 {width:578px!important;}
+input.span-16, textarea.span-16 {width:618px!important;}
+input.span-17, textarea.span-17 {width:658px!important;}
+input.span-18, textarea.span-18 {width:698px!important;}
+input.span-19, textarea.span-19 {width:738px!important;}
+input.span-20, textarea.span-20 {width:778px!important;}
+input.span-21, textarea.span-21 {width:818px!important;}
+input.span-22, textarea.span-22 {width:858px!important;}
+input.span-23, textarea.span-23 {width:898px!important;}
+input.span-24, textarea.span-24 {width:938px!important;}
+.append-1 {padding-right:40px;}
+.append-2 {padding-right:80px;}
+.append-3 {padding-right:120px;}
+.append-4 {padding-right:160px;}
+.append-5 {padding-right:200px;}
+.append-6 {padding-right:240px;}
+.append-7 {padding-right:280px;}
+.append-8 {padding-right:320px;}
+.append-9 {padding-right:360px;}
+.append-10 {padding-right:400px;}
+.append-11 {padding-right:440px;}
+.append-12 {padding-right:480px;}
+.append-13 {padding-right:520px;}
+.append-14 {padding-right:560px;}
+.append-15 {padding-right:600px;}
+.append-16 {padding-right:640px;}
+.append-17 {padding-right:680px;}
+.append-18 {padding-right:720px;}
+.append-19 {padding-right:760px;}
+.append-20 {padding-right:800px;}
+.append-21 {padding-right:840px;}
+.append-22 {padding-right:880px;}
+.append-23 {padding-right:920px;}
+.prepend-1 {padding-left:40px;}
+.prepend-2 {padding-left:80px;}
+.prepend-3 {padding-left:120px;}
+.prepend-4 {padding-left:160px;}
+.prepend-5 {padding-left:200px;}
+.prepend-6 {padding-left:240px;}
+.prepend-7 {padding-left:280px;}
+.prepend-8 {padding-left:320px;}
+.prepend-9 {padding-left:360px;}
+.prepend-10 {padding-left:400px;}
+.prepend-11 {padding-left:440px;}
+.prepend-12 {padding-left:480px;}
+.prepend-13 {padding-left:520px;}
+.prepend-14 {padding-left:560px;}
+.prepend-15 {padding-left:600px;}
+.prepend-16 {padding-left:640px;}
+.prepend-17 {padding-left:680px;}
+.prepend-18 {padding-left:720px;}
+.prepend-19 {padding-left:760px;}
+.prepend-20 {padding-left:800px;}
+.prepend-21 {padding-left:840px;}
+.prepend-22 {padding-left:880px;}
+.prepend-23 {padding-left:920px;}
+div.border {padding-right:4px;margin-right:5px;border-right:1px solid #eee;}
+div.colborder {padding-right:24px;margin-right:25px;border-right:1px solid #eee;}
+.pull-1 {margin-left:-40px;}
+.pull-2 {margin-left:-80px;}
+.pull-3 {margin-left:-120px;}
+.pull-4 {margin-left:-160px;}
+.pull-5 {margin-left:-200px;}
+.pull-6 {margin-left:-240px;}
+.pull-7 {margin-left:-280px;}
+.pull-8 {margin-left:-320px;}
+.pull-9 {margin-left:-360px;}
+.pull-10 {margin-left:-400px;}
+.pull-11 {margin-left:-440px;}
+.pull-12 {margin-left:-480px;}
+.pull-13 {margin-left:-520px;}
+.pull-14 {margin-left:-560px;}
+.pull-15 {margin-left:-600px;}
+.pull-16 {margin-left:-640px;}
+.pull-17 {margin-left:-680px;}
+.pull-18 {margin-left:-720px;}
+.pull-19 {margin-left:-760px;}
+.pull-20 {margin-left:-800px;}
+.pull-21 {margin-left:-840px;}
+.pull-22 {margin-left:-880px;}
+.pull-23 {margin-left:-920px;}
+.pull-24 {margin-left:-960px;}
+.pull-1, .pull-2, .pull-3, .pull-4, .pull-5, .pull-6, .pull-7, .pull-8, .pull-9, .pull-10, .pull-11, .pull-12, .pull-13, .pull-14, .pull-15, .pull-16, .pull-17, .pull-18, .pull-19, .pull-20, .pull-21, .pull-22, .pull-23, .pull-24 {float:left;position:relative;}
+.push-1 {margin:0 -40px 1.5em 40px;}
+.push-2 {margin:0 -80px 1.5em 80px;}
+.push-3 {margin:0 -120px 1.5em 120px;}
+.push-4 {margin:0 -160px 1.5em 160px;}
+.push-5 {margin:0 -200px 1.5em 200px;}
+.push-6 {margin:0 -240px 1.5em 240px;}
+.push-7 {margin:0 -280px 1.5em 280px;}
+.push-8 {margin:0 -320px 1.5em 320px;}
+.push-9 {margin:0 -360px 1.5em 360px;}
+.push-10 {margin:0 -400px 1.5em 400px;}
+.push-11 {margin:0 -440px 1.5em 440px;}
+.push-12 {margin:0 -480px 1.5em 480px;}
+.push-13 {margin:0 -520px 1.5em 520px;}
+.push-14 {margin:0 -560px 1.5em 560px;}
+.push-15 {margin:0 -600px 1.5em 600px;}
+.push-16 {margin:0 -640px 1.5em 640px;}
+.push-17 {margin:0 -680px 1.5em 680px;}
+.push-18 {margin:0 -720px 1.5em 720px;}
+.push-19 {margin:0 -760px 1.5em 760px;}
+.push-20 {margin:0 -800px 1.5em 800px;}
+.push-21 {margin:0 -840px 1.5em 840px;}
+.push-22 {margin:0 -880px 1.5em 880px;}
+.push-23 {margin:0 -920px 1.5em 920px;}
+.push-24 {margin:0 -960px 1.5em 960px;}
+.push-1, .push-2, .push-3, .push-4, .push-5, .push-6, .push-7, .push-8, .push-9, .push-10, .push-11, .push-12, .push-13, .push-14, .push-15, .push-16, .push-17, .push-18, .push-19, .push-20, .push-21, .push-22, .push-23, .push-24 {float:right;position:relative;}
+.prepend-top {margin-top:1.5em;}
+.append-bottom {margin-bottom:1.5em;}
+.box {padding:1.5em;margin-bottom:1.5em;background:#E5ECF9;}
+hr {background:#ddd;color:#ddd;clear:both;float:none;width:100%;height:.1em;margin:0 0 1.45em;border:none;}
+hr.space {background:#fff;color:#fff;visibility:hidden;}
+.clearfix:after, .container:after {content:"\0020";display:block;height:0;clear:both;visibility:hidden;overflow:hidden;}
+.clearfix, .container {display:block;}
+.clear {clear:both;}

data/doc/public/css/style.css

@@ -0,0 +1,20 @@
+h2 { background: #ddd; text-align: center; padding: 4px; }
+
+.content { font-size: 1.2em; }
+.content h3 { background: #ffd; font-size: 1.5em; padding: 6px 2px; }
+
+#wrapper { text-align: left; width: 640px; } /* toc width */
+
+/* font styling */	
+#wrapper h1 { font-size: 18px; margin-bottom: 0.8em; text-align: left; }
+#wrapper a { color: #222; }
+#wrapper a:hover { color: #555; }
+#wrapper p { font-size: 18px; margin: 1.5em 0; }
+/*#wrapper p a { background: url(dot.gif) repeat-x bottom left; }*/
+
+/* start table of contents styling */
+ul#toc { list-style: none; width: 640px; padding-left: 0;}
+/*#toc li { background: url(dot.gif) repeat-x 0 0.85em; }*/
+#toc li a { font-size: 14px; background: #FFF; padding: 0 0 0 10px; }
+#toc li span { font-size: 14px; background: #FFF; padding: 0 0 0 4px; }
+#toc li br { clear: both; }

data/doc/push.txt

@@ -0,0 +1,135 @@
+Device Push
+===
+
+RhoConnect has a simple ruby API for sending push notifications to a user's devices.  This API can be called directly, queued as a resque job, or called remotely via the [RhoConnect REST API](/rhoconnect/rest-api). The push message can trigger the following actions in the rhodes application: alert with a message, sync one or more sources, vibrate, display a badge, play a sound file.
+
+We will now show you how to use the RhoConnect application to deliver push messages on each platform and how you can handle the push notification in your Rhodes application.
+
+## iOS
+To setup your RhoConnect application for iOS push, you will need to update `settings/settings.yml` to include the following:
+
+	:::yaml
+	:development: 
+	  :redis: localhost:6379
+	  :iphonecertfile: settings/apple_push_cert.pem
+	  :iphonepassphrase: #=> empty or put password for your certificate
+	  :iphoneserver: gateway.sandbox.push.apple.com
+	  :iphoneport: 2195
+	  :syncserver: http://localhost:9292/application/
+	  :licensefile: settings/license.key
+
+This is for running your application in development mode, for production you will need all of the iphone settings, and change the `:iphoneserver:` to:
+
+	:::yaml
+  	:iphoneserver: gateway.push.apple.com
+
+## Blackberry
+To setup your RhoConnect application for BlackBerry push, you will need to update `settings/settings.yml` to include the following:
+
+	:::yaml
+	:development: 
+	  :redis: localhost:6379
+	  :mdsserver: 192.168.1.110
+	  :mdsserverport: 8080
+	  :syncserver: http://localhost:9292/application/
+	  :licensefile: settings/license.key
+
+Replace `:mdsserver:` and `:mdsserverport:` with the hostname/IP and port of your machine (default port is 8080).
+
+## Android
+To setup your RhoConnect application for Android push, you will need to update `settings/settings.yml` to include the following:
+
+	:::yaml
+	:development:
+	  :redis: localhost:6379
+	  :syncserver: http://localhost:9292/application/
+	  :licensefile: settings/license.key
+	  :authtoken: authtoken
+
+Replace `:authtoken:` value with actual authentication token. This token MUST be related to the role-based google account registered for your application. See [the rhodes push instructions](/rhodes/device-caps#push-notifications) for more details. To retrieve this token, use sample script [c2dm.rb](http://github.com/rhomobile/rhodes/blob/master/bin/c2dm.rb). Uncomment last two lines and put your google account specific data, then run it. It will print token to stdout.
+
+For those who interested in what this token means, here is the description: <a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html"/>.
+
+Now start up your RhoConnect application and setup [push notifications](/rhodes/device-caps#push-notifications) in your Rhodes application.
+
+## Testing Push in the Web Console
+The [RhoConnect Web Console](/rhoconnect/web-console) includes a utility for testing push to make sure everything is wired up correctly.  
+
+First, make sure you've logged in and performed a sync on the device/simulator you are going to test. 
+
+Next, once you've logged into the web console, navigate to the user's page you used to login in the Rhodes application.  For example, if you logged in as user 't', the url would be: 
+
+	http://localhost:9292/console/user?user_id=t
+
+You should see a registered device for this user, for example: "c92e36874bc74f39a8fbd7c1a86f9e0e".  Click on the link for this device and you will see the device attributes:
+
+  	device_type: APPLE
+	device_pin:	10fd92abfa8ee48155d9af6e7329086322b323fd0d18fdbd19e92d03c0fef7c8
+	device_port: 100
+	user_id: t
+	app_id:	application
+
+**NOTE: If you don't see all of these attributes, then something is incorrect in your Rhodes application settings.  Please verify you followed the [Rhodes application push setup](/rhodes/device-caps#push-notifications).**
+
+Now that the device is registered, go back to the user page and click 'Ping User'.
+
+Here you can specify an alert message, sources array to sync, badge value (iOS only), sound file to play, and duration to vibrate.
+
+Enter in some values or try the defaults, you should see a push message on the device when you click "Ping!".
+
+By default, the sources list will be a comma-separated list of your RhoConnect application's sources.  This sources list will be sent in the push message to trigger a sync.  You can specify one or more sources, or 'all' to trigger a sync of all sources.
+
+## Push API
+The RhoConnect push API consists of executing a ping call.  There are three ways to execute a ping call:  use RhoConnect API to remotely call the ping, perform the ping job directly in a blocking ruby call, enqueue a resque job to ping asynchronously.
+
+### RhoConnect API Ping Method
+You can trigger a push remotely using the [RhoConnect API Ping method](/rhoconnect/rest-api).  This is useful if you want to fully control the push process from a remote server (instead of your source adapter).
+
+### Direct Push
+To perform a ping directly, you can call the following:
+
+	:::ruby
+	PingJob.perform(
+	  'user_id' => current_user.login,
+	  'sources' => ['Product','Customer'],
+	  'message' => 'hello world',
+	  'vibrate' => 2000,
+	  'sound' => 'hello.mp3'
+	)
+
+### Asynchronous Push
+To queue a ping that is executed asynchronously in a job, you can call the following:
+
+	:::ruby
+	Resque.enqueue(
+	  PingJob,
+	  'user_id' => current_user.login,
+	  'sources' => ['Product','Customer'],
+	  'message' => 'hello world',
+	  'vibrate' => 2000,
+	  'sound' => 'hello.mp3'
+	)
+
+**Note: For this job to execute, you will need to have a resque worker running.  See running [async jobs](/rhoconnect/async-jobs) for more information.**
+
+### Example
+Let's say we want to execute a ping for the `current_user` at the end of our source adapter query:
+
+	:::ruby
+	def query(params=nil)
+	  parsed = JSON.parse(RestClient.get("#{@base}.json").body)
+
+	  @result = {} 
+	  parsed.each do |item|
+	    @result[item["product"]["id"].to_s] = item["product"]
+	  end if parsed    
+	  PingJob.perform(
+	    'user_id' => current_user.login,
+	    'sources' => ['Product'],
+	    'message' => "There are new products!",
+	    'vibrate' => 2000
+	  )
+	end
+
+### Push Notifications in Rhodes
+Now that you can send push messages in your RhoConnect application, you can now handle the [push notification](/rhodes/device-caps#push-notifications) in your Rhodes application.

data/doc/release.txt

@@ -0,0 +1,41 @@
+RhoConnect Release Process
+===
+The RhoConnect release process addresses following requirements:
+
+* Introduce new features in timely fashion
+* Be very responsive to the bugs and requests from forum and customer requests
+* Provide the highest-quality possible
+* Provide up-to-date documentation and trackable CHANGELOG of the project history
+
+### Release cycle
+* Each release will be focused on a single feature (or a few small ones)
+* Each release will include bug fixes requested by customers 
+* Each release will be done in 1-2 weeks time
+
+### Versioning
+Versioning will be done according to [http://semver.org/ Semantic Versioning] and input from pm/sales.
+
+### Pivotal tracker story workflow
+
+* Research is done, design/api is done and reviewed
+* Feature is split into smaller tasks and added to pivotal (recommended length of an individual task is 4-8 hours)  
+* Test code / implementation code cycle is done
+* Docs are written including relevant code samples or sample applications
+* Code review is done
+* CHANGELOG is updated with message under ## <version> header
+* Send announcement to dev@rhomobile.com about new feature with links to docs, samples, and tests
+
+### Conditions to accept pivotal story
+* Bug/feature is implemented or fixed and reviewed
+* Tests are written and reviewed
+* Docs are updated as needed
+* CHANGELOG is updated with message under ## <version> header
+
+### Release steps
+* To make a release one or more features or bugs should be accepted in pivotal
+* Make sure each feature & bugfix has an entry in CHANGELOG under ## <version> header
+* To accept feature or bug in pivotal see instructions above
+* Tag applied to git and gem is created
+* When all test tickets are accepted gem is released to rubygems.org
+* Pivotal milestone is marked completed
+* The same procedure follows for minor release