Commented flyweight example.

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;

flyweight/src/main/java/com/iluwatar/App.java

 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 )

flyweight/src/main/java/com/iluwatar/Potion.java

 package com.iluwatar;
 
+/**
+ * 
+ * Interface for objects.
+ *
+ */
 public interface Potion {
 
 	public void drink();

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;