Commented factory method example.

factory-method/src/main/java/com/iluwatar/App.java

@@ -1,5 +1,13 @@
 package com.iluwatar;
 
+/**
+ * 
+ * In Factory Method we have an interface (Blacksmith) with a
+ * method for creating objects (manufactureWeapon). The concrete
+ * subclasses (OrcBlacksmith, ElfBlacksmith) then override the 
+ * method to produce objects of their liking.
+ *
+ */
 public class App 
 {
     public static void main( String[] args )

factory-method/src/main/java/com/iluwatar/Blacksmith.java

@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * The interface containing method for producing objects.
+ *
+ */
 public interface Blacksmith {
 
 	Weapon manufactureWeapon(WeaponType weaponType);

factory-method/src/main/java/com/iluwatar/ElfBlacksmith.java

@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Concrete subclass for creating new objects.
+ *
+ */
 public class ElfBlacksmith implements Blacksmith {
 
 	public Weapon manufactureWeapon(WeaponType weaponType) {

factory-method/src/main/java/com/iluwatar/OrcBlacksmith.java

@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Concrete subclass for creating new objects.
+ *
+ */
 public class OrcBlacksmith implements Blacksmith {
 
 	public Weapon manufactureWeapon(WeaponType weaponType) {