Updates to Ruby tutorial

Author: michael-w-williams

ruby/intro/README.md

@@ -1,110 +1,25 @@
 # Introduction to Fn with Ruby
-
 Fn is a lightweight Docker-based serverless functions platform you can run on
 your laptop, server, or cloud.  In this introductory tutorial we'll walk through
-installing Fn, develop a function using Ruby (without installing a Ruby
-compiler!) and deploy them to a local Fn server.  We'll also learn about the core
-Fn concepts like applications and routes.
+developing a function using the Ruby programming language (without installing
+any Ruby tools!) and deploying that function to a local Fn server.  We'll also
+learn about the core Fn concepts like applications and routes.
 
-So let's get started!
+### Before you Begin
+* Set aside about 15 minutes to complete this tutorial.
+* Make sure Fn server is up and running by completing the [Install and Start Fn Tutorial](../../install/README.md).
 
-As you make your way through this tutorial, look out for this icon.
+> As you make your way through this tutorial, look out for this icon.
 ![](images/userinput.png) Whenever you see it, it's time for you to
 perform an action.
 
-
-## Installing Fn
-
-Setting up a working Fn install is a two-step process.  First you need
-to ensure you have the necessary prerequisites and then you can install
-Fn itself.
-
-### Prerequisites
-
-Before we can install Fn you'll need:
-
-1. A computer running Linux or MacOS.  If you have a Windows machine the
-easiest thing to do is install [VirtualBox](https://www.virtualbox.org/)
-and run a free Linux virtual machine.
-2. [Docker](https://www.docker.com/) 17.05 (or higher) needs to be
-installed and running.
-
-> __NOTE__ In this tutorial we'll work in a purely local development
-mode.  However, when deploying functions to a remote Fn server, a Docker
-Hub (or other Docker registry) account is required.
-
-That's it.  You can use your favorite IDE for function development.
-However, for this tutorial, an IDE isn't necessary.
-
-
-### Downloading and Installing Fn
-
-From a terminal type the following:
-
-![](images/userinput.png)
->`curl -LSs https://raw.githubusercontent.com/fnproject/cli/master/install | sh`
-
-Once installed you'll see the Fn version printed out.  You should see
-something similar to the following displayed (although likely with a later
-version number):
-
-```sh
-fn version 0.4.66
-```
-
-### Starting Fn Server
-
-The final install step is to start the Fn server.  Since Fn runs on
-Docker it'll need to be up and running too.
-
-To start Fn you can use the `fn` command line interface (CLI).  Type the
-following but note that the process will run in the foreground so that
-it's easy to stop with Ctrl-C:
-
-![user input](images/userinput.png)
->`fn start`
-
-You should see output similar to:
-
-```sh
-time="2017-09-18T14:37:13Z" level=info msg="datastore dialed" datastore=sqlite3 max_idle_connections=256
-time="2017-09-18T14:37:13Z" level=info msg="available memory" ram=1655975936
-time="2017-09-18T14:37:13Z" level=info msg="Serving Functions API on address `:8080`"
-
-      ______
-     / ____/___
-    / /_  / __ \
-   / __/ / / / /
-  /_/   /_/ /_/
-```
-
-Let's verify everthing is up and running correctly.
-
-**Open a new terminal** and run the following:
-
-![user input](images/userinput.png)
->`fn version`
-
-You should see the version of the fn CLI (client) and server displayed (your version will
-likely differ):
-
-```sh
-Client version:  0.4.66
-Server version:  0.3.385
-```
-
-If the server version is "?" then the fn CLI cannot reach the server.  If
-this happens it's likely you have something else running on port 8080. In this
-case stop the other process, and stop (ctrl-c) and restart the fn server as
-described previously.
-
 ## Your First Function
-
-Let's start with a very simple "hello world" function written in [Ruby](https://www.ruby-lang.org/). Don't worry, you don't need to know Ruby!  In
-fact you don't even need to have Ruby installed on your development machine as
-Fn provides the necessary Ruby compiler and tools as a Docker container.  Let's
-walk through your first function to become familiar with the process and how Fn
-supports development.
+Let's start with a very simple "hello world" function written in
+[Ruby](https://www.ruby-lang.org/). Don't worry, you don't need to know Ruby!
+In fact you don't even need to have Ruby installed on your development machine
+as Fn provides the necessary Ruby compiler and tools as a Docker container.
+Let's walk through your first function to become familiar with the process and
+how Fn supports development.
 
 Before we start developing we need to set the `FN_REGISTRY`
 environment variable.  Normally, it's set to your Docker Hub username.
@@ -232,7 +147,7 @@ the necessary Docker images.
 > `fn run`
 
 ```yaml
-Building image fndemouser/rubyfn:0.0.1 
+Building image fndemouser/rubyfn:0.0.1
 call_id: 12345678901234567890123456
 {"message":"Hello World!"}
 ```
@@ -248,7 +163,7 @@ enabled.
 > `fn --verbose run`
 
 ```yaml
-Building image fndemouser/rubyfn:0.0.1 
+Building image fndemouser/rubyfn:0.0.1
 Sending build context to Docker daemon  6.144kB
 Step 1/9 : FROM fnproject/ruby:dev as build-stage
  ---> 907fbac5f177
@@ -290,7 +205,7 @@ You can also pass data to the run command. For example:
 >```
 
 ```yaml
-Building image fndemouser/rubyfn:0.0.1 
+Building image fndemouser/rubyfn:0.0.1
 call_id: 12345678901234567890123456
 {"message":"Hello Bob!"}
 ```
@@ -351,7 +266,7 @@ You should see output similar to:
 ```yaml
 Deploying rubyfn to app: rubyapp at path: /rubyfn
 Bumped to version 0.0.2
-Building image fndemouser/rubyfn:0.0.2 
+Building image fndemouser/rubyfn:0.0.2
 Updating route /rubyfn using image fndemouser/rubyfn:0.0.2...
 ```
 
@@ -430,7 +345,7 @@ that incorporates our application and function route as path elements.
 Use curl to invoke the function:
 
 ![user input](images/userinput.png)
->`curl http://localhost:8080/r/rubyapp/rubyfn`
+>`curl -H "Content-Type: application/json" http://localhost:8080/r/rubyapp/rubyfn`
 
 The result is once again the same.
 
@@ -442,7 +357,7 @@ We can again pass JSON data to our function get the value of name passed to the
 function back.
 
 ![user input](images/userinput.png)
->`curl http://localhost:8080/r/rubyapp/rubyfn -d '{"name":"Bob"}'`
+>`curl -H "Content-Type: application/json" -d '{"name":"Bob"}' http://localhost:8080/r/rubyapp/rubyfn`
 
 The result is once again the same.