@@ -1,5 +1,10 @@
 package CalculatorExample1;
 
+
+// This is a naive implementation of a calculator class without generics. 
+// Note here that we're only able to take integers. 
+// What if we want to pass in a double or a pair of doubles?
+
 class Calc {
 	public int add(int a, int b) {
 		return a+b;
 
@@ -1,6 +1,9 @@
 package CalculatorExample1;
 
-
+ // Here we are using the concepts of generics to be able to pass in any given 
+// type  (as long as it inherits from the Number superclass).  This will also return 
+// a double, however, we could also return a type <T> which, again, is defined at 
+// compile time. 
 
 	class MyCalc <T extends Number> {
 		public double add(T a, T b) {
@@ -25,6 +28,10 @@ public double  div (T a, T b) {
 public class CalcExample2 {
 	public static void main(String args[]) {
 	    	MyCalc c = new MyCalc();
+	    	
+	    	// Here we can freely pass in any derived class of number without
+	    	// having to write a new method for each parameter signature.
+	    	
 	     	Double result = c.add(new Integer(1),new Double(1.0));
 		    System.out.println("result = " + result);