diff --git a/src/main/java/net/openhft/chronicle/map/Replica.java b/src/main/java/net/openhft/chronicle/map/Replica.java
index 107a45d24..4ba937eba 100644
--- a/src/main/java/net/openhft/chronicle/map/Replica.java
+++ b/src/main/java/net/openhft/chronicle/map/Replica.java
@@ -164,8 +164,7 @@ public interface Replica extends Closeable {
          * writeExternalEntry()}. This method is typically called when we receive a remote
          * replication event, this event could originate from either a remote {@code put(K key, V
          *value)} or {@code remove(Object key)}
-         * @param copies
-         * @param context
+         * @param context       the Bytes Replicated Context
          * @param source       bytes to read an entry from
          */
         void readExternalEntry(
diff --git a/src/main/java/net/openhft/chronicle/set/ChronicleSetBuilder.java b/src/main/java/net/openhft/chronicle/set/ChronicleSetBuilder.java
index 3e2befac3..787513507 100755
--- a/src/main/java/net/openhft/chronicle/set/ChronicleSetBuilder.java
+++ b/src/main/java/net/openhft/chronicle/set/ChronicleSetBuilder.java
@@ -117,7 +117,7 @@ public final class ChronicleSetBuilder<K>
      *
      * @see #constantKeySizeBySample(Object)
      * @see #actualChunkSize(int)
-     * @param averageKeySize
+     * @param averageKeySize   the average size in bytes of the key
      */
     @Override
     public ChronicleSetBuilder<K> averageKeySize(double averageKeySize) {