diff --git a/decorator/src/main/java/com/iluwatar/Hostile.java b/decorator/src/main/java/com/iluwatar/Hostile.java
index 480c4a17a..ff748a682 100644
--- a/decorator/src/main/java/com/iluwatar/Hostile.java
+++ b/decorator/src/main/java/com/iluwatar/Hostile.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Interface for the hostile enemies.
+ *
+ */
 public interface Hostile {
 
 	void attack();
diff --git a/decorator/src/main/java/com/iluwatar/SmartTroll.java b/decorator/src/main/java/com/iluwatar/SmartTroll.java
index 186f9c6b0..39ffe0249 100644
--- a/decorator/src/main/java/com/iluwatar/SmartTroll.java
+++ b/decorator/src/main/java/com/iluwatar/SmartTroll.java
@@ -1,5 +1,12 @@
 package com.iluwatar;
 
+/**
+ * SmartTroll is a decorator for Hostile objects.
+ * The calls to the Hostile interface are intercepted
+ * and decorated. Finally the calls are delegated
+ * to the decorated Hostile object.
+ *
+ */
 public class SmartTroll implements Hostile {
 
 	private Hostile decorated;
diff --git a/decorator/src/main/java/com/iluwatar/Troll.java b/decorator/src/main/java/com/iluwatar/Troll.java
index 397c04643..a0494a1f6 100644
--- a/decorator/src/main/java/com/iluwatar/Troll.java
+++ b/decorator/src/main/java/com/iluwatar/Troll.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Troll implements Hostile interface directly.
+ *
+ */
 public class Troll implements Hostile {
 
 	public void attack() {