Improved Facade Javadoc

iluwatar · iluwatar · commit 516b127d217c · 2015-10-03T21:11:19.000+03:00
diff --git a/facade/src/main/java/com/iluwatar/facade/App.java b/facade/src/main/java/com/iluwatar/facade/App.java
@@ -2,9 +2,15 @@
 
 /**
  * 
- * Facade ({@link DwarvenGoldmineFacade}) provides simpler interface to subsystem.
+ * The Facade design pattern is often used when a system is very complex or difficult 
+ * to understand because the system has a large number of interdependent classes or 
+ * its source code is unavailable. This pattern hides the complexities of the larger 
+ * system and provides a simpler interface to the client. It typically involves a single 
+ * wrapper class which contains a set of members required by client. These members access 
+ * the system on behalf of the facade client and hide the implementation details.
  * <p>
- * http://en.wikipedia.org/wiki/Facade_pattern
+ * In this example the Facade is ({@link DwarvenGoldmineFacade}) and it provides a simpler 
+ * interface to the goldmine subsystem.
  * 
  */
 public class App {
