Complete signup instructions and initial working pages

.gitignore

@@ -0,0 +1,31 @@
+# files which should not be included in any repository
+
+# OS directory files
+.directory
+*/.directory
+
+# editor backup files
+*~
+*kate-swp
+*/*~
+*/*kate-swp
+
+# built folder content (.html, .doc, .pdf)
+*build/*
+*/*build/*
+
+# deployment folder content
+*deploy/*
+*/*deploy/*
+
+# static folder content
+# *static/*
+*/*static/*
+# *include/*
+*/*include/*
+
+# keep directories which include .gitkeep
+!.git_keep
+!.gitkeep
+!*/.git_keep
+!*/.gitkeep

00_introduction.rst

@@ -0,0 +1,99 @@
+.. _introduction:
+
+#############################
+ Cloud Development
+#############################
+
+Why Use Cloud Development
+=============================
+
+In the past, web developers would use either Mac OS-X or Linux as the base for 
+a development environment. On top of that they would install maybe a hundred or 
+so developer tools. Multiple projects might require different tools, or 
+incompatible versions of the same tools. Now cloud services make each project a 
+separate configurable service instance, removing some of the complexity and 
+compatibility issues from development environments.
+
+With cloud services, it does not matter what local computer one uses. 
+What matters is that one can connect to the Internet with a web browser which 
+fully supports HTML5. Previously programmers had to carry their development 
+environments around, meaning they had to use laptops. Cloud services allow 
+programmers to use available computers whereever they are.
+
+Currently several cloud services are required to provide all the features a 
+programming team would require for web development. This document describes one 
+selection of cloud services which results in a flexible web programming 
+configuration. Other, possibly better, choices may exist, but that is a 
+discussion beyond the scope of this project.
+
+Services Developers Need
+=============================
+
+This project uses free services which, in combination, present the essential 
+elements of a full web development environment. Typical web development needs 
+and the cloud services which emulate them are listed in the following table.
+
++---------------------------------+------------+------------------------------+
+| Development Environment Need    | Cloud Service Equivalent and URL          |
++=================================+============+==============================+
+| email                           | Gmail      | https://mail.google.com/     |
++---------------------------------+------------+------------------------------+
+| Linux console                   | Cloud9     | https://c9.io/               |
++---------------------------------+------------+------------------------------+
+| text editor (Kate)              | Cloud9     | https://c9.io/               |
++---------------------------------+------------+------------------------------+
+| code repository (Git)           | Cloud9     | https://c9.io/               |
++---------------------------------+------------+------------------------------+
+| public repository hosting (Git) | GitHub     | https://github.com/          |
++---------------------------------+------------+------------------------------+
+| programming language (RoR)      | Heroku     | https://heroku.com           |
++---------------------------------+------------+------------------------------+
+| web server                      | Heroku     | https://heroku.com           |                   
++---------------------------------+------------+------------------------------+
+| database (postgreSQL)           | Heroku     | https://heroku.com           |                           
++---------------------------------+------------+------------------------------+
+
+.. note::
+
+  Heroku includes client services: the `Heroku Toolbelt
+  <https://devcenter.heroku.com/x?url=https%3A%2F%2Ftoolbelt.heroku.com%2F>`_, 
+  Foreman, and Git.
+
+Logins and Passwords
+=============================
+
+This project requires registration with a number of different cloud services. 
+Each service has its own login requirements, as the following table shows.
+
++--------------------+-----------------------------------------------------------+
+|Service Login Id    | Character Requirement                                     |
++====================+===========================================================+ 
+| Gmail username     | Only letters (a-z), numbers, and periods                  |
++--------------------+-----------------------------------------------------------+
+| Gmail password     | 8+ characters: letters, numbers, spaces, or punctuation   |
++--------------------+-----------------------------------------------------------+
+| GitHub username    | alphanumeric characters or dashes not beginning with dash |
++--------------------+-----------------------------------------------------------+
+| GitHub password    | 7+ characters containing a lowercase letter and a number  |
++--------------------+-----------------------------------------------------------+
+| Heroku username    | your gmail address                                        |
++--------------------+-----------------------------------------------------------+
+| Heroku password    | 6 or more characters: letters, numbers, or symbols        |
++--------------------+-----------------------------------------------------------+
+| Cloud9 username    | Any character string, unique in Cloud9                    |
++--------------------+-----------------------------------------------------------+
+| Cloud9 password    | Any character string                                      |
++--------------------+-----------------------------------------------------------+
+
+A unique email address, username, and password which will work in all the above 
+websites would be helpful. Here are the requirements for this project:
+
++-------------+----------------------------+-------------------------------------+ 
+| Identifier  | Proposed pattern           | Example                             | 
++=============+============================+=====================================+ 
+| email name  | [email protected] | [email protected] | 
++-------------+----------------------------+-------------------------------------+ 
+| username    | vstem-lastname             | vstem-davenport                     | 
++-------------+----------------------------+-------------------------------------+ 
+| password    | 8+ char, 1 Upcase, 1 digit | D34rh34rt                           |
++-------------+----------------------------+-------------------------------------+ 

01_gmail.rst

@@ -0,0 +1,73 @@
+.. _setup_gmail:
+
+#############################
+ Create Gmail Account
+#############################
+
+Here are some reasons for having unsatisfactory email service: 
+
++ Internet Service Providers may not use effective SPAM filtering
++ Home email accounts may be shared with other users
++ Email using POP3 for delivery is not accessible on public computers
++ Email using provider POP3 accounts is not persistent
++ Mail may not persist in the cloud, so information is lost
++ Organizational coordination requires standardization of email addresses
+
+The first step in cloud development is to have a web identity. Google's Gmail 
+is an excellent email service which is available free for individual accounts. 
+Use the following instructions to sign up for a Google account and Gmail.
+
+Get a Google  Account
+=============================
+
+.. sidebar:: GMail Signup
+
+  .. image:: _images/01_gmail-1.png
+
+In your web browser, right-click the following link and open it in a new tab:
+
+  https://accounts.google.com/SignUpWidget
+
+Then fill out the **GMail Signup** form as follows:
+
++--------------------------------+------------------------------------+
+| **Name**                       | Actual first name, then Last name  |
++--------------------------------+------------------------------------+
+| **Choose your username**       | VSTEM.Firstname.Lastname           |
++--------------------------------+------------------------------------+
+| **Create a password**          | Use 8 or more letters or numbers   |
++--------------------------------+------------------------------------+
+| **Confirm your password**      | Retype your password               |
++--------------------------------+------------------------------------+
+| **Birthday**                   | Use your birth date, year < 1999   |
++--------------------------------+------------------------------------+
+| **Gender**                     | Make a selection                   |
++--------------------------------+------------------------------------+
+| **Mobile phone**               | Enter this if you want to          |
++--------------------------------+------------------------------------+
+| **Your current email address** | Required for notifications         |
++--------------------------------+------------------------------------+
+| **Prove you're not a robot**   | type word <space> word             |
++--------------------------------+------------------------------------+
+| **Location**                   | United States                      |
++--------------------------------+------------------------------------+
+|**I agree to the Google . . .** | Check this box                     |
++--------------------------------+------------------------------------+
+
+Click button :guilabel:`Next step` to complete the form. You will see your 
+profile page display. Again, click button :guilabel:`Next step` to continue. 
+A welcome page will display, showing that your new account is ready. 
+
+.. image:: _images/01_gmail-2.png
+
+Click :guilabel:`Next step` one last time to view the final account setup page.
+Now go to your new Gmail account. Right-click the link https://mail.google.com 
+and choose  :menuselection:`Open in new tab`. 
+
+.. note::
+
+  You will receive an email at your current email address with a verification 
+  code. You may wish to print out that email, and forward the email to your new 
+  VSTEM mailbox. An example verification email is shown following: 
+
+  .. image:: _images/01_gmail-3.png 

02_github.rst

@@ -0,0 +1,25 @@
+.. _setup_github:
+
+#############################
+ Create GitHub Account
+#############################
+
+Use this guide to setup free public repository storage and hosting on GitHub. 
+
+Register a GitHub Account
+=============================
+
++ Click this link to `the GitHub signup page <https://github.com/signup/free>`_. 
++ Enter your information (four fields).
++ Click on :guilabel:`Create an account`.
+
+.. image:: _images/02_github-1.png
+
+Login to GitHub
+=============================
+
++ Click this link to login to GitHub: https://github.com/session
++ Enter your **Username** and **Password**
++ Click the :guilabel:`Sign in` button
+
+.. image:: _images/02_github-2.png

03_heroku.rst

@@ -0,0 +1,22 @@
+.. _setup_heroku:
+
+#############################
+ Create Heroku Account
+#############################
+
++ Signup for Heroku at this link: https://api.heroku.com/signup
++ Enter your Gmail account ID and then click :guilabel:`Sign up`
+
+.. image:: _images/03_heroku-1.png
+
++ Open your mail at https://mail.google.com
++ Look for the message, "Confirm your account on Heroku"
++ Click the signup link to complete the Heroku signup
+
+.. image:: _images/03_heroku-2.png
+
++ The email link will take you to the Heroku Confirmation page
++ Enter your development password and confirm it
++ click button :guilabel:`Save` to register and login
+
+.. image:: _images/03_heroku-3.png

04_cloud9.rst

@@ -0,0 +1,38 @@
+.. _setup_cloud9:
+
+#############################
+ Create Cloud9 Account
+#############################
+
+.. sidebar:: Cloud9 Standard is Free
+
+  .. image:: _images/04_cloud9-1.png
+
+Sign up for free Cloud9 developer workspace.
+
++ Click button :guilabel:`SIGN UP FOR  FREE` at https://c9.io/site/pricing/ 
++ Enter your developer username
++ Enter your developer email address, and confirm it
+
+.. image:: _images/04_cloud9-2.png
+
++ Click button :guilabel:`Create your free account`
+
+.. image:: _images/04_cloud9-3.png
+
++ In your Gmail, read :guilabel:`Welcome to Cloud9! Please activate your account!`
++ Click the link to activate your account
+
+.. image:: _images/04_cloud9-4.png
+
++ In the resulting webpage, enter your developer password and confirm it
+
+.. image:: _images/04_cloud9-5.png
+
+Your Cloud9 workspace will display at https://c9.io/vstem-username
+
++ Click the page title to set your full name
+
+.. image:: _images/04_cloud9-6.png
+
+Congratulations. Now you have a Linux workspace in the cloud, available to you from any computer with a web browser which supports HTML5.