added some text edits and rewording in re issues #5#1

Author: tkoar

README.md

@@ -5,71 +5,54 @@
 
 In the past few lessons, we have learned about working with different types of data in Python: strings, numbers (ints and floats), and booleans.  Now let's put that knowledge into action.
 
-In this lesson we'll imagine that you just stopped by an Python programming conference and met a few people there.  You exchanged some information with a very industrious person who you met, and want to use your programming skills to format this information correctly.  
+In this lesson we'll imagine that we were at a nice social gathering and exchanged business cards with a few people.  One of the business cards belongs to Art Vandelay, a new travel agent. We want to use our programming skills to format this information correctly. 
 
 ### Learning Objectives
 * Manipulate strings with built-in methods
 * Practice coercing data types and changing numbers
 
 ### Here to mingle 
 
-The next morning you take out the business card, ready to format it using your programming skills, and here is what you find.
+The next morning we take out the business card, ready to format it using our programming skills, and here is what we find.
 
-![](./biz-card-mistakes.jpg)
+![](https://learn-verified.s3.amazonaws.com/data-science-assets/biz-card-mistakes.jpg)
 
-Yea, he may not be the best person to get to know.  But we know that when people fill out forms, they misenter information all of the time.  As a celebrity once said, "I'm really getting into the Internet lately, I just wish it were more organized."
+Yea, Mr. Vandelay may not be the best person to get to know or the best at designing business cards, but like Mr. Vandelay, we know that people misenter information on forms all the time.
 
-And as data scientists, we also see the need of organizing and cleaning data to then make sense of it.  So let's get to work.
+So as data scientists, we often need to clean and organize data before we can make sense of it.  Let's get to work. 
 
-### Solving your first lab
+### Solving our first lab
 
-This is your first lab, and here you'll see that we have provided some data for you.  Next to the data, you will see a comment indicating what the data should look after you change it.  Let's do the first one together.  For example, let's say we want to capitalize all of the letters of "art vandlay" (to remind ourselves of how he made his introduction).  You'll see the following:
+This is our first lab, and here we'll see that there is some data already provided for us.  Next to the data, we will see a comment indicating what the data should look like after we change it.  Let's do the first one together.  
+
+For example, let's say we want to capitalize all of the letters of "art vandlay".  We'll see the following:
 
 
 ```python
 "art vandelay" # 'ART VANDELAY'
 ```
 
+Notice that there is no output below the gray code above.  This is because Jupyter notebooks do not automatically run our code - so they do not automatically know the output.  To display the output, we must **run** the code by clicking on the gray cell and then pressing shift + enter.  Let's try it in the cell above and see our output appear below.
 
-
-
-    'art vandelay'
-
-
-
-That hash tag to the right is a comment.  Comments are used for programmers to annotate their code.  But a comment has no impact on the code.
+Ok, once we see the output take a look at the hash tag to the right of the string.  The hash tag to the right is a comment.  Comments are used for programmers to annotate their code, but a comment has no impact on the code.  See this by running the next cell below (again, press shift + enter).
 
 
 ```python
 'hello'
 ### whattttt
 ```
 
+If we press shift+enter on the cell above to run the code, we will see that Python happily ignores the comment.  So here (and in future labs), a comment will be provided to indicate what we should see as the return value of our code.  When we press shift+enter, and the output below matches the comment to the right of our code, we did it correctly.
 
+> In future labs, Learn will check our code to ensure that we did it correctly.  But for our first lab, this works fine.
 
-
-    'hello'
-
-
-
-If you press shift+enter to run the code in the cell, you will see that Python happily ignores the comment.  So in labs, we provide the comment to indicate what you should see as the return value of your code.  When you press shift+enter, and the output below matches the comment to the right of your code, you did it correctly.
-
-> In future labs, Learn will check your code to ensure that you did it correctly.  But for your first lab, this works fine.
-
-And change it to the following:
+To get our output to match the comment we will change it to the following:
 
 
 ```python
 "art vandelay".upper() # 'ART VANDELAY'
 ```
 
-
-
-
-    'ART VANDELAY'
-
-
-
 ### Get going with strings
 
 First use the `title` method to capitalize the first letter of each word in "art vandelay"`.
@@ -79,83 +62,41 @@ First use the `title` method to capitalize the first letter of each word in "art
 "art vandelay" # 'Art Vandelay'
 ```
 
-
-
-
-    'art vandelay'
-
-
-
 Now let's uppercase all of the letters of "Ceo".
 
 
 ```python
 "Ceo" # 'CEO'
 ```
 
-
-
-
-    'Ceo'
-
-
-
-Now write a method that answers a question about our email addresses.  Every email address should end with ".com".  Use your knowledge of string methods to check if the email address ends with ".com" and return `True` or `False` accordingly. 
+Next, write a method that answers a question about our email addresses.  Every email address should end with ".com".  We can use our knowledge of string methods to check if the email address ends with ".com" and return `True` or `False` accordingly. 
 
 
 ```python
-"art.vandelay@vandelay.cop" # False
+"art.vandelay@vandelay.co" # False
 ```
 
-
-
-
-    'art.vandelay@vandelay.cop'
-
-
-
-As you can see, the website "vandelay.com" is not preceded by `"www."`.  Use the plus sign to change the website 'vandelay.com' to the string `'www.vandelay.com'`.
+As you can see below, the website "vandelay.com" is not preceded by `"www."`. We can perform what is called string interpolation to fix this! Use the plus sign, `'+'`, to change the website `'vandelay.com'` to the string `'www.vandelay.com'` by prepending `'www.'`.
 
 
 ```python
 'vandelay.com' # 'www.vandelay.com'
 ```
 
-
-
-
-    'vandelay.com'
-
-
-
 ### Working with numbers
 
-Finally, Mr. Vandelay gave us his phone number, but he actually has a second number different ones listed.  All three numbers are the same except for the ending.  Coerce the string of his phone number to an `int` and add one, then add two to change the number.  
+Finally, Mr. Vandelay gave us his phone number, but he actually has two other phone numbers that are different from the one listed.  All three numbers are basically the same with the excepion of the ending. Below, start by coercing the first phone number, which is currently a string, to an `int` and add one. Next do the same to the second phone number but increase it by two.
 
 
 ```python
 "7285553334" # 7285553335
 ```
 
 
-
-
-    '7285553334'
-
-
-
-
 ```python
 "7285553334" # 7285553336
 ```
 
-
-
-
-    '7285553334'
-
-
-
 ### Summary
 
-Your first lab done!  Sweet.  In this lab, you practiced working with string methods to operate on and answer questions about strings.  You wrote methods that return Booleans.  And you changed strings to an `int` to then perform addition.  So much of working with data, is ensuring that our data is properly formatted so we can then operate on it and in this lab you saw how to use code to just that.
+Our first lab is done! Sweet. In this lab, we practiced working with string methods to operate on and answer questions about strings. We wrote methods that return Booleans and changed strings to intergers in order to perform addition. So much of working with data is ensuring that it is properly formatted so we can then operate on it, and in this lab, we saw how to use code to do just that.

index.ipynb

@@ -20,7 +20,7 @@
    "source": [
     "In the past few lessons, we have learned about working with different types of data in Python: strings, numbers (ints and floats), and booleans.  Now let's put that knowledge into action.\n",
     "\n",
-    "In this lesson we'll imagine that at a nice social gathering you exchanged business cards with a few people.  One of the business cards belongs to Art Vandelay, a new travel agent. You want to use your programming skills to format this information correctly. "
+    "In this lesson we'll imagine that we were at a nice social gathering and exchanged business cards with a few people.  One of the business cards belongs to Art Vandelay, a new travel agent. We want to use our programming skills to format this information correctly. "
    ]
   },
   {
@@ -43,7 +43,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "The next morning you take out the business card, ready to format it using your programming skills, and here is what you find."
+    "The next morning we take out the business card, ready to format it using our programming skills, and here is what we find."
    ]
   },
   {
@@ -66,16 +66,16 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### Solving your first lab"
+    "### Solving our first lab"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "This is your first lab, and here you'll see that we have provided some data for you.  Next to the data, you will see a comment indicating what the data should look like after you change it.  Let's do the first one together.  \n",
+    "This is our first lab, and here we'll see that there is some data already provided for us.  Next to the data, we will see a comment indicating what the data should look like after we change it.  Let's do the first one together.  \n",
     "\n",
-    "For example, let's say we want to capitalize all of the letters of \"art vandlay\".  You'll see the following:"
+    "For example, let's say we want to capitalize all of the letters of \"art vandlay\".  We'll see the following:"
    ]
   },
   {
@@ -93,14 +93,14 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Notice that there is no output below the gray code above.  This is because Jupyter notebooks do not automatically run our code - so they do not automatically know the output.  To display the output, you must **run** the code by clicking on the gray cell and then pressing shift + enter.  Try it above and you will see output below the cell."
+    "Notice that there is no output below the gray code above.  This is because Jupyter notebooks do not automatically run our code - so they do not automatically know the output.  To display the output, we must **run** the code by clicking on the gray cell and then pressing shift + enter.  Let's try it in the cell above and see our output appear below."
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Ok, once you see the output take a look at the hash tag to the right of the string.  The hash tag to the right is a comment.  Comments are used for programmers to annotate their code, but a comment has no impact on the code.  See this by running the next cell below (again, press shift + enter)."
+    "Ok, once we see the output take a look at the hash tag to the right of the string.  The hash tag to the right is a comment.  Comments are used for programmers to annotate their code, but a comment has no impact on the code.  See this by running the next cell below (again, press shift + enter)."
    ]
   },
   {
@@ -119,21 +119,21 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "If you press shift+enter on the cell above to run the code, you will see that Python happily ignores the comment.  So here (and in future labs), we will provide the comment to indicate what you should see as the return value of your code.  When you press shift+enter, and the output below matches the comment to the right of your code, you did it correctly."
+    "If we press shift+enter on the cell above to run the code, we will see that Python happily ignores the comment.  So here (and in future labs), a comment will be provided to indicate what we should see as the return value of our code.  When we press shift+enter, and the output below matches the comment to the right of our code, we did it correctly."
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "> In future labs, Learn will check your code to ensure that you did it correctly.  But for your first lab, this works fine."
+    "> In future labs, Learn will check our code to ensure that we did it correctly.  But for our first lab, this works fine."
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "To get our output to match comment we will change it to the following:"
+    "To get our output to match the comment we will change it to the following:"
    ]
   },
   {
@@ -194,13 +194,15 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Next, write a method that answers a question about our email addresses.  Every email address should end with \".com\".  Use your knowledge of string methods to check if the email address ends with \".com\" and return `True` or `False` accordingly. "
+    "Next, write a method that answers a question about our email addresses.  Every email address should end with \".com\".  We can use our knowledge of string methods to check if the email address ends with \".com\" and return `True` or `False` accordingly. "
    ]
   },
   {
    "cell_type": "code",
    "execution_count": null,
-   "metadata": {},
+   "metadata": {
+    "collapsed": true
+   },
    "outputs": [],
    "source": [
     "\"art.vandelay@vandelay.co\" # False"
@@ -210,7 +212,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "As you can see below, the website \"vandelay.com\" is not preceded by `\"www.\"`. We can perform what is called string interpolation to fix this! Use the plus sign, `+`, to change the website `'vandelay.com'` to the string `'www.vandelay.com'` by prepending `'www.'`."
+    "As you can see below, the website \"vandelay.com\" is not preceded by `\"www.\"`. We can perform what is called string interpolation to fix this! Use the plus sign, `'+'`, to change the website `'vandelay.com'` to the string `'www.vandelay.com'` by prepending `'www.'`."
    ]
   },
   {
@@ -236,7 +238,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Finally, Mr. Vandelay gave us his phone number, but he actually has a second phone number that is different from the one listed.  All three numbers are basically the same with the excepion of the ending. Below, start by coercing each phone number, which are currently strings, to an `int` and add one to the first and add two to the second to change the numbers."
+    "Finally, Mr. Vandelay gave us his phone number, but he actually has two other phone numbers that are different from the one listed.  All three numbers are basically the same with the excepion of the ending. Below, start by coercing the first phone number, which is currently a string, to an `int` and add one. Next do the same to the second phone number but increase it by two."
    ]
   },
   {
@@ -272,7 +274,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Your first lab done!  Sweet.  In this lab, you practiced working with string methods to operate on and answer questions about strings.  You wrote methods that return Booleans and changed strings to intergers in order to perform addition. So much of working with data is ensuring that it is properly formatted so we can then operate on it, and in this lab, you saw how to use code to just that."
+    "Our first lab is done! Sweet. In this lab, we practiced working with string methods to operate on and answer questions about strings. We wrote methods that return Booleans and changed strings to intergers in order to perform addition. So much of working with data is ensuring that it is properly formatted so we can then operate on it, and in this lab, we saw how to use code to do just that."
    ]
   }
  ],