@@ -1,2 +1,31 @@
-# DesignPatternsJava9
-This repo consists Gang of Four Design patterns code on Java 9. Each branch in the repository has code of 1 design pattern. Switch repository to try out different design patterns.
+# What is Facade Design Pattern
+* Facade pattern adds an interface to existing system or group of sub systems to hide its complexities
+* This pattern involves a single class which provides interface with simplified methods required by client and delegates calls to methods of existing system classes.
+
+## Diagram
+![Diagram](https://.com/premaseem/DesignPatternsJava9/blob/facade-pattern/diagrams/4_3%20Facade%20class%20diagram.jpeg "Diagram")
+
+![Diagram](https://.com/premaseem/DesignPatternsJava9/blob/facade-pattern/diagrams/4_3%20facade%20sequence.png "Diagram")
+
+### When to use Facade Design Pattern
+When application needs a simplified interface to the overall functionality of a complex subsystem.
+
+### Learn Design Patterns with Java by Aseem Jain
+This repository contains working project code used in video Course by Packt Publication with title "Learn Design Patterns with Java " authored by "Aseem Jain".
+
+### Course link:
+https://www.packtpub.com/application-development/learn-design-patterns-java-9-video
+
+### ![ http://in.linkedin.com/in/premaseem](https://.com/premaseem/DesignPatternsJava9/blob/master/linkedin.png "http://in.linkedin.com/in/premaseem") Profile: http://in.linkedin.com/in/premaseem
+
+### Authors blog on design patterns:
+https://premaseem.wordpress.com/category/computers/design-patterns/
+
+### Software Design pattern community face book page:
+https://www.facebook.com/DesignPatternGuru/
+
+### Note:
+* This code base will work on Java 9 and above versions.
+* `diagrams` folders carry UML diagrams.
+* `pattern` folder has code of primary example.
+* `patternBonus` folder has code of secondary or bonus example.