Improved comments for decorator example.

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();

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;

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() {