Copy edits and code tweaks

Author: adamd

config.yml

@@ -1,9 +1,8 @@
 title: Intermediate Python
-tagline: Create a REST api with Node.js, Express.js, and MongoDB
+tagline: 'Random numbers, variables, and conditionals'
 description: Learn how to create a dice-rolling app with Python!
 tags:
   - Python
-
 template:
   name: intermediate-python-course
   repo: intermediate-python-course-template
@@ -12,84 +11,78 @@ before:
   - type: createIssue
     title: Set up your project
     body: 01-setup.md
-
 steps:
   - title: Set up your project
     description: Introduces the project and how to set it up
     event: issue_comment
-    link: "{{ repoUrl }}/issues/1"
-    actions: 
+    link: '{{ repoUrl }}/issues/1'
+    actions:
       - type: respond
         with: 01-running.md
         issue: 1
         data:
           game: '%payload.comment.body%'
-
   - title: Running a Python program
     description: Run a python program with a main method
     event: push
-    link: "{{ repoUrl }}/issues/1"
-    actions: 
+    link: '{{ repoUrl }}/issues/1'
+    actions:
       - type: respond
         with: 01-complete.md
         issue: 1
       - type: closeIssue
         issue: 1
       - type: createIssue
-        title: Using Variables 
+        title: Using Variables
         body: 02-variables.md
-
   - title: Using Variables
     description: Define variables with random input to simulate a die-roll
     event: issue_comment
-    link: "{{ repoUrl }}/issues/2"
-    actions: 
+    link: '{{ repoUrl }}/issues/2'
+    actions:
       - type: respond
         with: 02-multiple.md
         issue: 2
-        data: 
+        data:
           roll: '%payload.comment.body%'
-
   - title: Rolling multiple Dice
     description: Roll multiple dice and add their results
     event: push
-    link: "{{ repoUrl }}/issues/2"
+    link: '{{ repoUrl }}/issues/2'
     actions:
       - type: respond
         with: 02-complete.md
         issue: 2
       - type: closeIssue
         issue: 2
       - type: createIssue
-        title: Adding Conditionals 
+        title: Adding Conditionals
         body: 03-conditionals.md
-
   - title: Adding Conditionals
     description: Add some flavor to your responses with conditionals
     event: issue_comment
-    link: "{{ repoUrl }}/issues/3"
-    actions: 
+    link: '{{ repoUrl }}/issues/3'
+    actions:
       - type: gate
         left: '%payload.comment.body%'
         operator: <
         right: 3
         else:
-        - type: respond
-          with: 03-unlucky.md
-          data: 
-            rollNum: '%payload.comment.body%'
+          - type: respond
+            with: 03-unlucky.md
+            data:
+              rollNum: '%payload.comment.body%'
       - type: respond
         with: 03-lucky.md
-        data: 
+        data:
           rollNum: '%payload.comment.body%'
-
   - title: Adding User Input
     description: Allow users to input the number and size of dice
     event: push
-    link: "{{ repoUrl }}/issues/3"
+    link: '{{ repoUrl }}/issues/3'
     actions:
       - type: respond
         with: 03-complete.md
         issue: 3
       - type: closeIssue
-        issue: 3
+        issue: 3

responses/01-running.md

@@ -12,8 +12,8 @@ def main():
 Below that, you'll see an `if` statement calling that function:
 
 ```python
-`if __name__== "__main__":
-    main()`
+if __name__== "__main__":
+    main()
 ```
 By doing this, the function `main` will run whenever you run the Python script. As you develop the dice roller, be sure to only manipulate the code within the `main` function; nothing else will need to be changed. 
 

responses/02-multiple.md

@@ -27,10 +27,9 @@ We would then have a set of commands it would do for every `i`. We already have
 
 ## Manipulating Variables
 
-With a `for` loop implemented, your code takes the form of this:
+With a `for` loop implemented, your main function takes this form:
 
 ```python
-import random
 dice_rolls = 2
 for i in range(0,dice_rolls):
   roll = random.randint(1,6)
@@ -57,20 +56,24 @@ dice_sum += roll
 
 It doesn't matter which version you prefer, just go with whichever way is easier for you to visualize. Finally, let's print out our final value for `dice_sum`. After the `for` loop is finished, type:
 ```python
-print('You have rolled a total of {dice_sum}')
+print(f'You have rolled a total of {dice_sum}')
 ```
-Make sure this statement is not indented (since that would include it in the for loop). Overall, your code should look like this:
+Make sure this statement is not indented (since that would include it in the for loop). Overall, your main function should look like this:
 
 ```python
-import random
 dice_rolls = 2
 dice_sum = 0
 for i in range(0,dice_rolls):
   roll = random.randint(1,6)
   dice_sum += roll
   print(f'You rolled a {roll}')
-print('You have rolled a total of {dice_sum}')
+print(f'You have rolled a total of {dice_sum}')
 ```
 If you save and run the file, you'll now get the values of the two dice rolls and their combined sum. Now our code is developing some complexity!
 
-*[Push your code]({{ repoUrl }}/issues/1) to GitHub to continue*
+**Push your code** to GitHub to continue:
+```
+git add dice_roller.py
+git commit -m "Now rolling two dice"
+git push
+```

responses/02-variables.md

@@ -35,12 +35,14 @@ To use a package, we'll need to import it. At the top of the file, import the pa
 import random 
 ```
 
-In general, it's good practice to import all packages at the beginning of the script. Now let's use that package to randomize our `roll` variable. To get a random integer with the `random` package, we'll want to use the following format:
+In general, it's good practice to import all packages at the beginning of the script. Now let's use that package to randomize our `roll` variable.
+
+To get a random integer with the `random` package, we'll update the `roll` line like so:
 
 ```python
-random.randint(X,Y)
+roll = random.randint(1,6)
 ```
 
-where X and Y are the boundaries of the range you want your random integers to be in. Note that X, the beginning of the range and Y, and the end of the range, are inclusive bounds. Note that X (the beginning of the range) and Y (the end of the range), are inclusive bounds. This means the integers you put as X and Y will be part of possible values. Knowing that, try changing `roll` to equal any integer that is possible to roll on a six-sided die: 1, 2, 3, 4, 5 and 6. There's no need to change anything in the print statement, as we've already tied it to whatever our `roll` variable is. 
+The `random.randint` function takes two integers as parameters. In this case, since we want to emulate a six-sided die, we want to include the range of results that is possible: 1, 2, 3, 4, 5 and 6. Note that the beginning and the end of the range are inclusive bounds. That is, 1 and 6 are possible values, along with integers between them.
 
 Now run the code and put *the number* you rolled as a comment, and then we'll keep this tutorial *rolling*!

responses/03-conditionals.md

@@ -23,10 +23,9 @@ elif roll == 6:
   print(f'You rolled a {roll}! Critical Success!')
 ```
 
-With the conditionals added, your code should look something like this:
+With the conditionals added, your main function should look something like this:
 
 ```python
-import random
 dice_rolls = 2
 dice_sum = 0
 for i in range(0,dice_rolls):

responses/03-lucky.md

@@ -6,15 +6,15 @@ We have a working dice roller right now! It's useful for a very specific situati
 
 Instead of having `dice_rolls` set to a specific value, let's set it equal to:
 ```python
-int(input('How many dice would you like to roll?'))
+int(input('How many dice would you like to roll? '))
 ```
 
 Running the code will give a prompt with that question and we can input our desired number of dice. One thing to note: the value a user inputs defaults to a `str` type and we need it to be a whole number, or an `int` in Python; that's why we encompass the `input` command in an `int()`. Try it out!
 
 Tabletop games use dice with all number of sides so it'll be useful to add a user input for that too. Below where you set `dice_rolls` add this line:
 
 ```python
-dice_size = int(input('How many sides are the dice?'))
+dice_size = int(input('How many sides are the dice? '))
 ```
 
 Change the max value of our roll like this
@@ -30,12 +30,12 @@ elif roll == dice_size:
 
 Try it out! Now you can manually input the number of dice and number of sides on the dice knowing that the `Critical Success!` line will realign accordingly. 
 
-Your final code should look like this:
+Your final main function should look like this:
 
 ```python
 import random
-dice_rolls = int(input('How many dice would you like to roll?'))
-dice_size = int(input('How many sides are the dice?'))
+dice_rolls = int(input('How many dice would you like to roll? '))
+dice_size = int(input('How many sides are the dice? '))
 dice_sum = 0
 for i in range(0,dice_rolls):
   roll = random.randint(1,dice_size)
@@ -46,6 +46,12 @@ for i in range(0,dice_rolls):
     print(f'You rolled a {roll}! Critical Success!')
   else:
     print(f'You rolled a {roll}')
-print('You have rolled a total of {dice_sum}')
+print(f'You have rolled a total of {dice_sum}')
 ```
-*[Push your code]({{ repoUrl }}/issues/1) to GitHub to finish the course!*
+
+**Push your code** to GitHub to continue:
+```
+git add dice_roller.py
+git commit -m "Tutorial complete"
+git push
+```

responses/03-unlucky.md

@@ -6,15 +6,15 @@ We have a working dice roller right now! It's useful for a very specific situati
 
 Instead of having `dice_rolls` set to a specific value, let's set it equal to:
 ```python
-int(input('How many dice would you like to roll?'))
+int(input('How many dice would you like to roll? '))
 ```
 
 Running the code will give a prompt with that question and we can input our desired number of dice. One thing to note: the value a user inputs defaults to a `str` type and we need it to be a whole number, or an `int` in Python; that's why we encompass the `input` command in an `int()`. Try it out!
 
 Tabletop games use dice with all number of sides so it'll be useful to add a user input for that too. Below where you set `dice_rolls` add this line:
 
 ```python
-dice_size = int(input('How many sides are the dice?'))
+dice_size = int(input('How many sides are the dice? '))
 ```
 
 Change the max value of our roll like this
@@ -30,12 +30,11 @@ elif roll == dice_size:
 
 Try it out! Now you can manually input the number of dice and number of sides on the dice knowing that the `Critical Success!` line will realign accordingly. 
 
-Your final code should look like this:
+Your final main function should look like this:
 
 ```python
-import random
-dice_rolls = int(input('How many dice would you like to roll?'))
-dice_size = int(input('How many sides are the dice?'))
+dice_rolls = int(input('How many dice would you like to roll? '))
+dice_size = int(input('How many sides are the dice? '))
 dice_sum = 0
 for i in range(0,dice_rolls):
   roll = random.randint(1,dice_size)
@@ -46,6 +45,12 @@ for i in range(0,dice_rolls):
     print(f'You rolled a {roll}! Critical Success!')
   else:
     print(f'You rolled a {roll}')
-print('You have rolled a total of {dice_sum}')
+print(f'You have rolled a total of {dice_sum}')
 ```
-*[Push your code]({{ repoUrl }}/issues/1) to GitHub to finish the course!*
+
+**Push your code** to GitHub to continue:
+```
+git add dice_roller.py
+git commit -m "Tutorial complete"
+git push
+```