diff --git a/chain/src/main/java/com/iluwatar/App.java b/chain/src/main/java/com/iluwatar/App.java
index 33693a1d5..92b85b54d 100644
--- a/chain/src/main/java/com/iluwatar/App.java
+++ b/chain/src/main/java/com/iluwatar/App.java
@@ -1,5 +1,13 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Chain of Responsibility organizes request handlers (RequestHandler) into
+ * a chain where each handler has a chance to act on the request on its
+ * turn. In this example the king (OrcKing) makes requests and the military
+ * orcs (OrcCommander, OrcOfficer, OrcSoldier) form the handler chain.
+ *
+ */
 public class App 
 {
     public static void main( String[] args )
diff --git a/chain/src/main/java/com/iluwatar/OrcKing.java b/chain/src/main/java/com/iluwatar/OrcKing.java
index 894499878..dc70494ef 100644
--- a/chain/src/main/java/com/iluwatar/OrcKing.java
+++ b/chain/src/main/java/com/iluwatar/OrcKing.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Makes requests that are handled by the chain.
+ *
+ */
 public class OrcKing {
 
 	RequestHandler chain;