diff --git a/facade/src/main/java/com/iluwatar/App.java b/facade/src/main/java/com/iluwatar/App.java
index 1db60124b..6a99d0322 100644
--- a/facade/src/main/java/com/iluwatar/App.java
+++ b/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 {
diff --git a/facade/src/main/java/com/iluwatar/DwarvenCartOperator.java b/facade/src/main/java/com/iluwatar/DwarvenCartOperator.java
index ef13611a8..dcb440c04 100644
--- a/facade/src/main/java/com/iluwatar/DwarvenCartOperator.java
+++ b/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
diff --git a/facade/src/main/java/com/iluwatar/DwarvenGoldDigger.java b/facade/src/main/java/com/iluwatar/DwarvenGoldDigger.java
index ea7c7e68e..50c1d4e09 100644
--- a/facade/src/main/java/com/iluwatar/DwarvenGoldDigger.java
+++ b/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
diff --git a/facade/src/main/java/com/iluwatar/DwarvenGoldmineFacade.java b/facade/src/main/java/com/iluwatar/DwarvenGoldmineFacade.java
index dba27210e..fc5af7338 100644
--- a/facade/src/main/java/com/iluwatar/DwarvenGoldmineFacade.java
+++ b/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;
diff --git a/facade/src/main/java/com/iluwatar/DwarvenMineWorker.java b/facade/src/main/java/com/iluwatar/DwarvenMineWorker.java
index 9a8249281..27ec4e87b 100644
--- a/facade/src/main/java/com/iluwatar/DwarvenMineWorker.java
+++ b/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() {
diff --git a/facade/src/main/java/com/iluwatar/DwarvenTunnelDigger.java b/facade/src/main/java/com/iluwatar/DwarvenTunnelDigger.java
index b8ef18332..02f7807a7 100644
--- a/facade/src/main/java/com/iluwatar/DwarvenTunnelDigger.java
+++ b/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