diff --git a/state/src/main/java/com/iluwatar/App.java b/state/src/main/java/com/iluwatar/App.java
index e0096c846..92a87619d 100644
--- a/state/src/main/java/com/iluwatar/App.java
+++ b/state/src/main/java/com/iluwatar/App.java
@@ -1,5 +1,13 @@
 package com.iluwatar;
 
+/**
+ * 
+ * In State pattern the object (Mammoth) has internal
+ * state object (State) that defines the current
+ * behavior. The state object can be changed
+ * to alter the behavior.
+ *
+ */
 public class App 
 {
     public static void main( String[] args )
diff --git a/state/src/main/java/com/iluwatar/Mammoth.java b/state/src/main/java/com/iluwatar/Mammoth.java
index 6f9f28b33..78fb19682 100644
--- a/state/src/main/java/com/iluwatar/Mammoth.java
+++ b/state/src/main/java/com/iluwatar/Mammoth.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Mammoth has internal state that defines its behavior.
+ *
+ */
 public class Mammoth {
 	
 	private State state;
diff --git a/state/src/main/java/com/iluwatar/State.java b/state/src/main/java/com/iluwatar/State.java
index cee5eda69..3570a63f7 100644
--- a/state/src/main/java/com/iluwatar/State.java
+++ b/state/src/main/java/com/iluwatar/State.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * State interface.
+ *
+ */
 public interface State {
 
 	void onEnterState();