Improved comments for the facade example.

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

@@ -3,6 +3,7 @@ package com.iluwatar;
 /**
  * 
  * Facade (DwarvenGoldmineFacade) provides simpler interface to subsystem.
+ * http://en.wikipedia.org/wiki/Facade_pattern
  * 
  */
 public class App {

facade/src/main/java/com/iluwatar/DwarvenCartOperator.java

@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * DwarvenCartOperator is one of the goldmine subsystems.
+ *
+ */
 public class DwarvenCartOperator extends DwarvenMineWorker {
 
 	@Override

facade/src/main/java/com/iluwatar/DwarvenGoldDigger.java

@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * DwarvenGoldDigger is one of the goldmine subsystems.
+ *
+ */
 public class DwarvenGoldDigger extends DwarvenMineWorker {
 
 	@Override

facade/src/main/java/com/iluwatar/DwarvenGoldmineFacade.java

@@ -3,6 +3,16 @@ package com.iluwatar;
 import java.util.ArrayList;
 import java.util.List;
 
+/**
+ * 
+ * DwarvenGoldmineFacade provides a single interface
+ * through which users can operate the subsystems.
+ * 
+ * This makes the goldmine easier to operate and
+ * cuts the dependencies from the goldmine user to
+ * the subsystems.
+ *
+ */
 public class DwarvenGoldmineFacade {
 
 	List<DwarvenMineWorker> workers;

facade/src/main/java/com/iluwatar/DwarvenMineWorker.java

@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * DwarvenMineWorker is one of the goldmine subsystems.
+ *
+ */
 public abstract class DwarvenMineWorker {
 
 	public void goToSleep() {

facade/src/main/java/com/iluwatar/DwarvenTunnelDigger.java

@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * DwarvenTunnelDigger is one of the goldmine subsystems.
+ *
+ */
 public class DwarvenTunnelDigger extends DwarvenMineWorker {
 
 	@Override