Fix style and clarify instructions

Author: phrdang

2_intermediate/chapter11/solutions/number_mystery_1.py

@@ -1,19 +1,27 @@
-# Write a function that takes in 3 integers. Get the sum of the 3 integers. Get
-# the difference between the largest integer and the smallest integer. The
-# function will return the product of these two integers you got.
+# Number Mystery 1
+# Write a function called num_mystery that takes in 3 integers.
+# The function should calculate the sum of the 3 integers and
+# the difference between the largest integer and the smallest integer.
+# The function should return the product of these two integers you calculated.
 #
-# Use this function on 1,2,3 and print it. Use this function on 5,13,7 and
-# print it
+# Hint: You may find it useful to use the max() and min() functions.
+#
+# Use the num_mystery function on 1, 2, 3 and print the result.
+# Use the num_mystery function on 5, 13, 7 and print the result.
 
 
 def num_mystery(first_int, second_int, third_int):
+    # calculate the sum of the 3 numbers
     sum_of_three = first_int + second_int + third_int
+
+    # calculate the difference between the max and min
     largest = max(first_int, second_int, third_int)
     smallest = min(first_int, second_int, third_int)
-    diff_ls = largest - smallest
+    difference = largest - smallest
 
-    return sum_of_three * diff_ls
+    # return the product
+    return sum_of_three * difference
 
 
-print(num_mystery(1, 2, 3))  # should print 12
-print(num_mystery(5, 13, 7))  # should print 200
+print(num_mystery(1, 2, 3))  # prints 12
+print(num_mystery(5, 13, 7))  # prints 200