Starter ruby app (#999)

* rename this file

* refactor ruby tutorial to be a starter app.

source/release-notes/v1.8-release-notes.rst

@@ -268,7 +268,7 @@ Added Sinatra Ruby Gems into ondemand-gems for other apps to use
 ................................................................
 
 Related Ruby gems for the micro-webframework "Sinatra" were added to the Dashboard Gemfile to ensure they are included in the ``ondemand-gems`` RPM.
-Simple applications like the Passenger status app featured in the :ref:`Passenger app development tutorial <app-development-tutorials-passenger-apps-ps-to-quota>` can now be run without needing to install gem dependencies into the application directory. The following gems were added for this purpose:
+Simple applications like the Passenger status app featured in the :ref:`Ruby Starter application <app-development-tutorials-passenger-apps-starter-ruby-app>` can now be run without needing to install gem dependencies into the application directory. The following gems were added for this purpose:
 
 .. code-block:: ruby
 

source/tutorials/tutorials-passenger-apps.rst

@@ -11,6 +11,6 @@ At the bottom of the page is a list of tutorials for developing Passenger apps f
    :maxdepth: 2
    :caption: Tutorials
 
-   tutorials-passenger-apps/ps-to-quota
+   tutorials-passenger-apps/ruby-starter-app
    tutorials-passenger-apps/nodejs-starter-app
    tutorials-passenger-apps/python-starter-app

source/tutorials/tutorials-passenger-apps/deploy-to-production.inc

@@ -0,0 +1,52 @@
+Publish App
+-----------
+
+Publishing an app requires two steps:
+
+#. Updating the ``manifest.yml`` to specify the category and optionally subcategory, which indicates where in the dashboard menu the app appears.
+
+#. Having an administrator checkout a copy of the production version to a directory under ``/var/www/ood/apps/sys``.
+
+
+Steps:
+
+#. Add category to manifest so the app appears in the Files menu:
+
+    .. code-block:: diff
+
+        name: Quota
+        description: Display quotas
+        icon: fa://hdd-o
+        +category: Files
+        +subcategory: Utilities
+
+#. Version these changes. Click **Shell** button on app details view, and then ``commit`` the changes:
+
+    .. code-block:: sh
+
+       git add .
+       git commit -m "update manifest for production"
+
+       # if there is an external remote associated with this, push to that
+       git push origin master
+
+#. As the admin, ``sudo copy`` or ``git clone`` this repo to production
+
+    .. code-block:: sh
+
+       # as sudo on OnDemand host:
+       cd /var/www/ood/apps/sys
+       git clone /users/PZS0562/efranz/ondemand/dev/quota
+
+
+#. **Reload** the dashboard.
+
+.. figure:: /images/app-dev-tutorial-ps-to-quota-published.png
+   :align: center
+
+   Every user can now launch the Quota from the Files menu.
+
+.. warning::
+
+   Accessing this new app for the first time will cause your NGINX server to restart,
+   killing all websocket connections, which means resetting your active web-based OnDemand Shell sessions.

source/tutorials/tutorials-passenger-apps/nodejs-starter-app.rst

@@ -91,5 +91,7 @@ There you should see this application at the top of the list.  Clicking
 When the new tab opens you should see a blank page with the text ``Hello World``.
 This is your new `NodeJs`_ application!
 
+.. include:: deploy-to-production.inc
+
 .. _NodeJs: https://nodejs.org/en
 .. _Express: https://expressjs.com/