diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/AllModemVisitor.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/AllModemVisitor.java
index 8a0c29b8e..e6f583446 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/AllModemVisitor.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/AllModemVisitor.java
@@ -22,6 +22,9 @@
  */
 package com.iluwatar.acyclicvisitor;
 
+/**
+ * All ModemVisitor interface extends all visitor interfaces
+ */
 public interface AllModemVisitor extends ModemVisitor, ZoomVisitor, HayesVisitor{
 
 }
diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/App.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/App.java
index 97fdddf14..06e4bd2f2 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/App.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/App.java
@@ -30,7 +30,7 @@ package com.iluwatar.acyclicvisitor;
  * <p>
  * In this example the visitor base class is {@link ModemVisitor}. The base class of the 
  * visited hierarchy is {@link Modem} and has two children {@link Hayes} and {@link Zoom} 
- * each one having its own visitor interface {@link Hayes} and {@link ZoomVisitor} 
+ * each one having its own visitor interface {@link HayesVisitor} and {@link ZoomVisitor} 
  * respectively. {@link ConfigureForUnixVisitor} and {@link ConfigureForDosVisitor} 
  * implement each derivative's visit method only if it is required 
  */
diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Hayes.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Hayes.java
index 657a669b0..1128057bf 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Hayes.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Hayes.java
@@ -33,7 +33,7 @@ public class Hayes extends Modem {
   private static final Logger LOGGER = LoggerFactory.getLogger(ConfigureForDosVisitor.class);
 
   /**
-   * Accept visitor
+   * Accepts all visitors but honors only HayesVisitor
    */
   @Override
   public void accept(ModemVisitor modemVisitor) {
diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ModemVisitor.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ModemVisitor.java
index a9aaad6d4..7189a6bba 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ModemVisitor.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ModemVisitor.java
@@ -23,7 +23,9 @@
 package com.iluwatar.acyclicvisitor;
 
 /**
- * ModemVisitor interface
+ * ModemVisitor interface does not contain any visit methods so that it does not
+ * depend on the visited hierarchy. Each derivative's visit method is declared in 
+ * its own visitor interface
  */
 public interface ModemVisitor {
   // Visitor is a degenerate base class for all visitors.
diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Zoom.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Zoom.java
index f14c9e7e6..7091d79df 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Zoom.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Zoom.java
@@ -33,7 +33,7 @@ public class Zoom extends Modem {
   private static final Logger LOGGER = LoggerFactory.getLogger(ConfigureForDosVisitor.class);
 
   /**
-   * Accept visitor
+   * Accepts all visitors but honors only ZoomVisitor
    */
   @Override
   public void accept(ModemVisitor modemVisitor) {