diff --git a/iterator/src/main/java/com/iluwatar/App.java b/iterator/src/main/java/com/iluwatar/App.java
index b3ca3d491..0ee92de1b 100644
--- a/iterator/src/main/java/com/iluwatar/App.java
+++ b/iterator/src/main/java/com/iluwatar/App.java
@@ -1,5 +1,12 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Iterator (ItemIterator) adds abstraction layer on top of a 
+ * collection (TreasureChest). This way the collection can change 
+ * its internal implementation without affecting its clients.
+ *
+ */
 public class App 
 {
     public static void main( String[] args )
diff --git a/iterator/src/main/java/com/iluwatar/ItemIterator.java b/iterator/src/main/java/com/iluwatar/ItemIterator.java
index 6c05d6f5c..1a6da1cd4 100644
--- a/iterator/src/main/java/com/iluwatar/ItemIterator.java
+++ b/iterator/src/main/java/com/iluwatar/ItemIterator.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Iterator interface.
+ *
+ */
 public interface ItemIterator {
 
 	boolean hasNext();
diff --git a/iterator/src/main/java/com/iluwatar/TreasureChest.java b/iterator/src/main/java/com/iluwatar/TreasureChest.java
index a0d69aab6..7cc80e7ff 100644
--- a/iterator/src/main/java/com/iluwatar/TreasureChest.java
+++ b/iterator/src/main/java/com/iluwatar/TreasureChest.java
@@ -3,6 +3,11 @@ package com.iluwatar;
 import java.util.ArrayList;
 import java.util.List;
 
+/**
+ * 
+ * Collection class.
+ *
+ */
 public class TreasureChest {
 
 	private List<Item> items;