diff --git a/mediator/src/main/java/com/iluwatar/App.java b/mediator/src/main/java/com/iluwatar/App.java
index 3ee09beb2..4a7053e84 100644
--- a/mediator/src/main/java/com/iluwatar/App.java
+++ b/mediator/src/main/java/com/iluwatar/App.java
@@ -1,5 +1,12 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Mediator encapsulates how set of objects (PartyMember) interact.
+ * Instead of referring to each other directly they
+ * use the mediator (Party) interface.
+ *
+ */
 public class App 
 {
     public static void main( String[] args )
diff --git a/mediator/src/main/java/com/iluwatar/Party.java b/mediator/src/main/java/com/iluwatar/Party.java
index a13311fe4..cf72b3103 100644
--- a/mediator/src/main/java/com/iluwatar/Party.java
+++ b/mediator/src/main/java/com/iluwatar/Party.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Mediator interface.
+ *
+ */
 public interface Party {
 
 	void addMember(PartyMember member);
diff --git a/mediator/src/main/java/com/iluwatar/PartyMember.java b/mediator/src/main/java/com/iluwatar/PartyMember.java
index 6a64cac77..80e04ba2f 100644
--- a/mediator/src/main/java/com/iluwatar/PartyMember.java
+++ b/mediator/src/main/java/com/iluwatar/PartyMember.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Interface for party members interacting with Party.
+ *
+ */
 public interface PartyMember {
 
 	void joinedParty(Party party);