diff --git a/flyweight/src/main/java/com/iluwatar/AlchemistShop.java b/flyweight/src/main/java/com/iluwatar/AlchemistShop.java
index 62c01c772..3d15668c8 100644
--- a/flyweight/src/main/java/com/iluwatar/AlchemistShop.java
+++ b/flyweight/src/main/java/com/iluwatar/AlchemistShop.java
@@ -3,6 +3,11 @@ package com.iluwatar;
 import java.util.ArrayList;
 import java.util.List;
 
+/**
+ * 
+ * The class that needs many objects.
+ *
+ */
 public class AlchemistShop {
 
 	List<Potion> topShelf;
diff --git a/flyweight/src/main/java/com/iluwatar/App.java b/flyweight/src/main/java/com/iluwatar/App.java
index 90b7131f6..d3b23dc86 100644
--- a/flyweight/src/main/java/com/iluwatar/App.java
+++ b/flyweight/src/main/java/com/iluwatar/App.java
@@ -1,5 +1,12 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Flyweight (PotionFactory) is useful when there is plethora of
+ * objects (Potion). It provides means to decrease resource usage
+ * by sharing object instances.
+ *
+ */
 public class App 
 {
     public static void main( String[] args )
diff --git a/flyweight/src/main/java/com/iluwatar/Potion.java b/flyweight/src/main/java/com/iluwatar/Potion.java
index 5c0d48a32..91cfabe3a 100644
--- a/flyweight/src/main/java/com/iluwatar/Potion.java
+++ b/flyweight/src/main/java/com/iluwatar/Potion.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Interface for objects.
+ *
+ */
 public interface Potion {
 
 	public void drink();
diff --git a/flyweight/src/main/java/com/iluwatar/PotionFactory.java b/flyweight/src/main/java/com/iluwatar/PotionFactory.java
index 54d98f411..d1eb09a74 100644
--- a/flyweight/src/main/java/com/iluwatar/PotionFactory.java
+++ b/flyweight/src/main/java/com/iluwatar/PotionFactory.java
@@ -2,6 +2,11 @@ package com.iluwatar;
 
 import java.util.EnumMap;
 
+/**
+ * 
+ * Flyweight.
+ *
+ */
 public class PotionFactory {
 
 	private EnumMap<PotionType, Potion> potions;