diff --git a/business-delegate/src/main/java/com/iluwatar/App.java b/business-delegate/src/main/java/com/iluwatar/App.java
index 15dc5e079..3f9ef41c6 100644
--- a/business-delegate/src/main/java/com/iluwatar/App.java
+++ b/business-delegate/src/main/java/com/iluwatar/App.java
@@ -1,5 +1,20 @@
 package com.iluwatar;
 
+/**
+ * 
+ * The Business Delegate pattern adds an abstraction layer between presentation and business tiers.
+ * By using the pattern we gain loose coupling between the tiers. The Business Delegate encapsulates
+ * knowledge about how to locate, connect to, and interact with the business objects that make up
+ * the application.
+ * 
+ * Some of the services the Business Delegate uses are instantiated directly, and some can be retrieved
+ * through service lookups. The Business Delegate itself may contain business logic too potentially tying
+ * together multiple service calls, exception handling, retrying etc.
+ * 
+ * In this example the client (Client) utilizes a business delegate (BusinessDelegate) to execute a task.
+ * The Business Delegate then selects the appropriate service and makes the service call.
+ *
+ */
 public class App {
 	
 	public static void main(String[] args) {
diff --git a/business-delegate/src/main/java/com/iluwatar/BusinessDelegate.java b/business-delegate/src/main/java/com/iluwatar/BusinessDelegate.java
index 3e20c81f4..a4893e728 100644
--- a/business-delegate/src/main/java/com/iluwatar/BusinessDelegate.java
+++ b/business-delegate/src/main/java/com/iluwatar/BusinessDelegate.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * BusinessDelegate separates presentation and business tiers
+ *
+ */
 public class BusinessDelegate {
 	
 	private BusinessLookup lookupService = new BusinessLookup();
diff --git a/business-delegate/src/main/java/com/iluwatar/BusinessLookup.java b/business-delegate/src/main/java/com/iluwatar/BusinessLookup.java
index f7bba0ca4..9fb7e07a5 100644
--- a/business-delegate/src/main/java/com/iluwatar/BusinessLookup.java
+++ b/business-delegate/src/main/java/com/iluwatar/BusinessLookup.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Class for performing service lookups
+ *
+ */
 public class BusinessLookup {
 
 	public BusinessService getBusinessService(ServiceType serviceType) {
diff --git a/business-delegate/src/main/java/com/iluwatar/BusinessService.java b/business-delegate/src/main/java/com/iluwatar/BusinessService.java
index 80fe4b273..c324ff8f9 100644
--- a/business-delegate/src/main/java/com/iluwatar/BusinessService.java
+++ b/business-delegate/src/main/java/com/iluwatar/BusinessService.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Interface for service implementations
+ *
+ */
 public interface BusinessService {
 
 	void doProcessing();
diff --git a/business-delegate/src/main/java/com/iluwatar/Client.java b/business-delegate/src/main/java/com/iluwatar/Client.java
index 7780e1abc..8c8c4ce1f 100644
--- a/business-delegate/src/main/java/com/iluwatar/Client.java
+++ b/business-delegate/src/main/java/com/iluwatar/Client.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Client utilizes BusinessDelegate to call the business tier
+ *
+ */
 public class Client {
 
 	private BusinessDelegate businessDelegate;
diff --git a/business-delegate/src/main/java/com/iluwatar/EjbService.java b/business-delegate/src/main/java/com/iluwatar/EjbService.java
index 0126cdc98..987bf73bd 100644
--- a/business-delegate/src/main/java/com/iluwatar/EjbService.java
+++ b/business-delegate/src/main/java/com/iluwatar/EjbService.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Service EJB implementation
+ *
+ */
 public class EjbService implements BusinessService {
 
 	@Override
diff --git a/business-delegate/src/main/java/com/iluwatar/JmsService.java b/business-delegate/src/main/java/com/iluwatar/JmsService.java
index ae71a1ba0..a7f1f1158 100644
--- a/business-delegate/src/main/java/com/iluwatar/JmsService.java
+++ b/business-delegate/src/main/java/com/iluwatar/JmsService.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Service JMS implementation
+ *
+ */
 public class JmsService implements BusinessService {
 
 	@Override
diff --git a/business-delegate/src/main/java/com/iluwatar/ServiceType.java b/business-delegate/src/main/java/com/iluwatar/ServiceType.java
index 6380bb8e6..fb9999e4a 100644
--- a/business-delegate/src/main/java/com/iluwatar/ServiceType.java
+++ b/business-delegate/src/main/java/com/iluwatar/ServiceType.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Enumeration for service types
+ *
+ */
 public enum ServiceType {
 	
 	EJB, JMS;