Detailed review of part 3 greeting section.

Author: audreyfeldroy

part-3.ipynb

@@ -10,7 +10,7 @@
    "name": "python2"
   },
   "name": "",
-  "signature": "sha256:98933314083fad8f511ddedbb2e2864dc55638392d8ce23f6cb46b78f049a2a3"
+  "signature": "sha256:21fa40ef7368043bdaf558035d71a9c7d07f9c147ef8083eadd7fe8a891b7ca2"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
@@ -67,7 +67,9 @@
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "Say we have a simple program that prints a happy birthday greeting:"
+      "Say we have a simple program that prints a happy birthday greeting for Carol.\n",
+      "\n",
+      "It's not Carol's birthday, but let's run this program anyway, just to confuse her in good fun ;)"
      ]
     },
     {
@@ -78,7 +80,16 @@
      ],
      "language": "python",
      "metadata": {},
-     "outputs": []
+     "outputs": [
+      {
+       "output_type": "stream",
+       "stream": "stdout",
+       "text": [
+        "Happy Birthday, dear Carol!\n"
+       ]
+      }
+     ],
+     "prompt_number": 1
     },
     {
      "cell_type": "markdown",
@@ -96,7 +107,8 @@
      ],
      "language": "python",
      "metadata": {},
-     "outputs": []
+     "outputs": [],
+     "prompt_number": 3
     },
     {
      "cell_type": "heading",
@@ -150,7 +162,9 @@
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "Don't forget those parenthesis.  Without the parenthesis Python wouldn't know we were trying to call our function, and will print out a statement "
+      "Don't forget those parentheses.  \n",
+      "\n",
+      "Without the parentheses, Python wouldn't know that we were trying to call our function, and will print out the value of the thing called `happy_birthday_carol`."
      ]
     },
     {
@@ -161,13 +175,38 @@
      ],
      "language": "python",
      "metadata": {},
-     "outputs": []
+     "outputs": [
+      {
+       "metadata": {},
+       "output_type": "pyout",
+       "prompt_number": 4,
+       "text": [
+        "<function __main__.happy_birthday_carol>"
+       ]
+      }
+     ],
+     "prompt_number": 4
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "Here, the Python interpreter is basically saying, \"The value of happy_birthday_carol is a function.\""
+     ]
+    },
+    {
+     "cell_type": "heading",
+     "level": 3,
+     "metadata": {},
+     "source": [
+      "Let's define and call another function"
+     ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "We can create a slew of functions named in a similar fashion:"
+      "That function printed a nice greeting for Carol. But Rise's now feeling left out. Let's define a function for her too."
      ]
     },
     {
@@ -179,7 +218,15 @@
      ],
      "language": "python",
      "metadata": {},
-     "outputs": []
+     "outputs": [],
+     "prompt_number": 5
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "Now, let's call the function:"
+     ]
     },
     {
      "cell_type": "code",
@@ -189,7 +236,24 @@
      ],
      "language": "python",
      "metadata": {},
-     "outputs": []
+     "outputs": [
+      {
+       "output_type": "stream",
+       "stream": "stdout",
+       "text": [
+        "Happy Birthday, dear Rise!\n"
+       ]
+      }
+     ],
+     "prompt_number": 6
+    },
+    {
+     "cell_type": "heading",
+     "level": 3,
+     "metadata": {},
+     "source": [
+      "Refactor time!"
+     ]
     },
     {
      "cell_type": "markdown",
@@ -201,7 +265,7 @@
       "\n",
       "Python allows us to do just that with function parameters.  We can add a parameter by typing a variable name in between the parethesis after our function name.  We can then use the parameter variable in our function.\n",
       "\n",
-      "We'll create a new function called 'happy_birthday', and add a parameter, 'name'."
+      "We'll create a new function called `happy_birthday`, and add a parameter, `name`."
      ]
     },
     {
@@ -213,13 +277,24 @@
      ],
      "language": "python",
      "metadata": {},
-     "outputs": []
+     "outputs": [],
+     "prompt_number": 18
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "Here, we are concatenating 3 strings:\n",
+      "* \"Happy Birthday, dear \"\n",
+      "* whatever the value of `name` is (Note: for the purposes of this example, let's assume that we're always getting a string)\n",
+      "* \"!\""
+     ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "To execute or run our new function, we simply call it by its name, 'happy_birthday' and pass a value in between the parenthesis, such as the string, 'Trey'."
+      "To execute or run our new function, we simply call it by its name, `happy_birthday`, and pass a value in between the parenthesis, such as the string `Trey`."
      ]
     },
     {
@@ -230,13 +305,30 @@
      ],
      "language": "python",
      "metadata": {},
-     "outputs": []
+     "outputs": [
+      {
+       "output_type": "stream",
+       "stream": "stdout",
+       "text": [
+        "Happy Birthday, dear Trey!\n"
+       ]
+      }
+     ],
+     "prompt_number": 19
+    },
+    {
+     "cell_type": "heading",
+     "level": 3,
+     "metadata": {},
+     "source": [
+      "Calling it over and over in a loop"
+     ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "Let's get a little bolder and make a list of names that we can loop over and then pass each one into our 'happy_birthday' function. What we get is the same results as the other earlier lines of code!"
+      "Let's get a little bolder and make a list of names that we can loop over and then pass each one into our `happy_birthday` function. What we get is the same results as the other earlier lines of code!"
      ]
     },
     {
@@ -247,7 +339,8 @@
      ],
      "language": "python",
      "metadata": {},
-     "outputs": []
+     "outputs": [],
+     "prompt_number": 23
     },
     {
      "cell_type": "code",
@@ -258,17 +351,37 @@
      ],
      "language": "python",
      "metadata": {},
-     "outputs": []
+     "outputs": [
+      {
+       "output_type": "stream",
+       "stream": "stdout",
+       "text": [
+        "Happy Birthday, dear Carol!\n",
+        "Happy Birthday, dear Rise!\n",
+        "Happy Birthday, dear Trey!\n",
+        "Happy Birthday, dear Alain!\n"
+       ]
+      }
+     ],
+     "prompt_number": 24
+    },
+    {
+     "cell_type": "heading",
+     "level": 2,
+     "metadata": {},
+     "source": [
+      "Example: Cupcake Calculation Function"
+     ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Now, let's see what we need to do to make a function return a value to where the function was initially called.\n",
       "\n",
-      "So let's create a new function, 'get_cupcake_count'.\n",
+      "So let's create a new function, `get_cupcake_count`.\n",
       "\n",
-      "We'll multiple the number of guests by two and return the result because each guest wants to eat two cupcakes."
+      "We'll multiply the number of guests by two and return the result because each guest wants to eat two cupcakes."
      ]
     },
     {