issue #333 diagrams and index added

factory-kit/src/main/java/com/iluwatar/factorykit/App.java

@@ -2,14 +2,14 @@ package com.iluwatar.factorykit;
 
 public class App {
 
-    public static void main(String[] args) {
-        WeaponFactory factory = WeaponFactory.factory(builder -> {
-            builder.add(WeaponType.SWORD, Sword::new);
-            builder.add(WeaponType.AXE, Axe::new);
-            builder.add(WeaponType.SPEAR, Spear::new);
-            builder.add(WeaponType.BOW, Bow::new);
-        });
-        Weapon axe = factory.create(WeaponType.AXE);
-        System.out.println(axe);
-    }
+  public static void main(String[] args) {
+    WeaponFactory factory = WeaponFactory.factory(builder -> {
+      builder.add(WeaponType.SWORD, Sword::new);
+      builder.add(WeaponType.AXE, Axe::new);
+      builder.add(WeaponType.SPEAR, Spear::new);
+      builder.add(WeaponType.BOW, Bow::new);
+    });
+    Weapon axe = factory.create(WeaponType.AXE);
+    System.out.println(axe);
+  }
 }

factory-kit/src/main/java/com/iluwatar/factorykit/Axe.java

@@ -1,7 +1,8 @@
 package com.iluwatar.factorykit;
 
 public class Axe implements Weapon {
-    @Override public String toString() {
-        return "Axe{}";
-    }
+  @Override
+  public String toString() {
+    return "Axe";
+  }
 }

factory-kit/src/main/java/com/iluwatar/factorykit/Bow.java

@@ -1,7 +1,8 @@
 package com.iluwatar.factorykit;
 
-/**
- * Created by crossy on 2016-01-16.
- */
 public class Bow implements Weapon {
+  @Override
+  public String toString() {
+    return "Bow";
+  }
 }

factory-kit/src/main/java/com/iluwatar/factorykit/Builder.java

@@ -2,6 +2,9 @@ package com.iluwatar.factorykit;
 
 import java.util.function.Supplier;
 
+/**
+ * Functional interface that allows adding builder with name to the factory
+ */
 public interface Builder {
-    void add(WeaponType name, Supplier<Weapon> supplier);
+  void add(WeaponType name, Supplier<Weapon> supplier);
 }

factory-kit/src/main/java/com/iluwatar/factorykit/Spear.java

@@ -1,7 +1,8 @@
 package com.iluwatar.factorykit;
 
 public class Spear implements Weapon {
-    @Override public String toString() {
-        return "Spear{}";
-    }
+  @Override
+  public String toString() {
+    return "Spear";
+  }
 }

factory-kit/src/main/java/com/iluwatar/factorykit/Sword.java

@@ -1,7 +1,8 @@
 package com.iluwatar.factorykit;
 
 public class Sword implements Weapon {
-    @Override public String toString() {
-        return "Sword{}";
-    }
+  @Override
+  public String toString() {
+    return "Sword";
+  }
 }

factory-kit/src/main/java/com/iluwatar/factorykit/Weapon.java

@@ -1,4 +1,7 @@
 package com.iluwatar.factorykit;
 
+/**
+ * Interface representing weapon
+ */
 public interface Weapon {
 }

factory-kit/src/main/java/com/iluwatar/factorykit/WeaponFactory.java

@@ -4,13 +4,18 @@ import java.util.HashMap;
 import java.util.function.Consumer;
 import java.util.function.Supplier;
 
+/**
+ * Functional interface that represents factory kit. Instance created locally gives an opportunity to strictly define
+ * which objects types the instance of a factory would be able to create. Factory is just a placeholder for builders with
+ * create method to initialize new objects.
+ */
 public interface WeaponFactory {
 
-    Weapon create(WeaponType name);
+  Weapon create(WeaponType name);
 
-    static WeaponFactory factory(Consumer<Builder> consumer) {
-        HashMap<WeaponType, Supplier<Weapon>> map = new HashMap<>();
-        consumer.accept(map::put);
-        return name -> map.get(name).get();
-    }
+  static WeaponFactory factory(Consumer<Builder> consumer) {
+    HashMap<WeaponType, Supplier<Weapon>> map = new HashMap<>();
+    consumer.accept(map::put);
+    return name -> map.get(name).get();
+  }
 }

factory-kit/src/main/java/com/iluwatar/factorykit/WeaponType.java

@@ -1,8 +1,5 @@
 package com.iluwatar.factorykit;
 
-/**
- * Created by crossy on 2016-01-16.
- */
 public enum WeaponType {
-    SWORD, AXE, BOW, SPEAR
+  SWORD, AXE, BOW, SPEAR
 }