Merge pull request #74 from braboj/5kydjt-codex/update-headers-in-python-examples

Clarify example headers

Author: braboj

examples/07_functions/func_factory.py

@@ -1,6 +1,7 @@
 # Function factories to create specialized functions
 # -----------------------------------------------------------------------------
-# Shows how to use higher-order functions to generate customized functions.
+# This example uses higher-order functions to generate customized
+# functions.
 
 def power_of(n):
     def power(x):

examples/07_functions/func_lambda_bytecodes.py

@@ -1,4 +1,8 @@
-# Example : Demonstrate that both lamda and def return the same result when compiled
+# Lambda and def produce the same bytecode
+# -----------------------------------------------------------------------------
+# This script compiles a lambda expression and a regular function to compare
+# their bytecode output.
+
 import dis
 
 func1 = lambda x: x * x

examples/08_classes/class_variables.py

@@ -1,4 +1,7 @@
-# Example: Class attributes
+# Working with class attributes
+# -----------------------------------------------------------------------------
+# This script uses class-level variables that apply to every instance
+# of the Person class.
 
 class Person(object):
 
@@ -11,7 +14,7 @@ def __init__(self, name, sex):
         self.sex = sex
 
     def get_prefix(self):
-        """ Demonstrate how to access class attributes from instance methods """
+        """Return the appropriate prefix using class attributes."""
 
         # The person is male
         if self.sex == "male":