Explain errors to be handled in TriangleProject2 (gregmalcolm#147)

alexvy86 · mpirnat · commit 9dca2c03cfef · 2016-12-04T20:04:55.000-05:00
diff --git a/python2/koans/about_triangle_project2.py b/python2/koans/about_triangle_project2.py
@@ -11,9 +11,15 @@ class AboutTriangleProject2(Koan):
     # The first assignment did not talk about how to handle errors.
     # Let's handle that part now.
     def test_illegal_triangles_throw_exceptions(self):
-        # Calls triangle(0, 0, 0)
+        # In the code below, each line calls the specfied method with the arguments passed to it.
+        # E.g. this line:
+        #   self.assertRaises(TriangleError, triangle, 0, 0, 0)
+        # calls triangle(0, 0, 0)
+        
+        # All sides should be greater than 0
         self.assertRaises(TriangleError, triangle, 0, 0, 0)
-
         self.assertRaises(TriangleError, triangle, 3, 4, -5)
+
+        # The sum of any two sides should be greater than the third one
         self.assertRaises(TriangleError, triangle, 1, 1, 3)
         self.assertRaises(TriangleError, triangle, 2, 5, 2)
diff --git a/python3/koans/about_triangle_project2.py b/python3/koans/about_triangle_project2.py
@@ -10,15 +10,15 @@ class AboutTriangleProject2(Koan):
     # The first assignment did not talk about how to handle errors.
     # Let's handle that part now.
     def test_illegal_triangles_throw_exceptions(self):
+        # All sides should be greater than 0
         with self.assertRaises(TriangleError):
             triangle(0, 0, 0)
-
         with self.assertRaises(TriangleError):
             triangle(3, 4, -5)
 
+        # The sum of any two sides should be greater than the third one
         with self.assertRaises(TriangleError):
             triangle(1, 1, 3)
-
         with self.assertRaises(TriangleError):
             triangle(2, 5, 2)
 
