diff --git a/src/main/java/net/openhft/chronicle/hash/impl/package-info.java b/src/main/java/net/openhft/chronicle/hash/impl/package-info.java
new file mode 100644
index 000000000..41ce23833
--- /dev/null
+++ b/src/main/java/net/openhft/chronicle/hash/impl/package-info.java
@@ -0,0 +1,16 @@
+/**
+ * This package and any and all sub-packages contains strictly internal classes for this Chronicle library.
+ * Internal classes shall <em>never</em> be used directly.
+ * <p>
+ *  Specifically, the following actions (including, but not limited to) are not allowed
+ *  on internal classes and packages:
+ *  <ul>
+ *      <li>Casting to</li>
+ *      <li>Reflection of any kind</li>
+ *      <li>Explicit Serialize/deserialize</li>
+ *  </ul>
+ * <p>
+ * The classes in this package and any sub-package are subject to
+ * changes at any time for any reason.
+ */
+package net.openhft.chronicle.hash.impl;
diff --git a/src/main/java/net/openhft/chronicle/hash/internal/package-info.java b/src/main/java/net/openhft/chronicle/hash/internal/package-info.java
new file mode 100644
index 000000000..9ef8d38d0
--- /dev/null
+++ b/src/main/java/net/openhft/chronicle/hash/internal/package-info.java
@@ -0,0 +1,16 @@
+/**
+ * This package and any and all sub-packages contains strictly internal classes for this Chronicle library.
+ * Internal classes shall <em>never</em> be used directly.
+ * <p>
+ *  Specifically, the following actions (including, but not limited to) are not allowed
+ *  on internal classes and packages:
+ *  <ul>
+ *      <li>Casting to</li>
+ *      <li>Reflection of any kind</li>
+ *      <li>Explicit Serialize/deserialize</li>
+ *  </ul>
+ * <p>
+ * The classes in this package and any sub-package are subject to
+ * changes at any time for any reason.
+ */
+package net.openhft.chronicle.hash.internal;
diff --git a/src/main/java/net/openhft/chronicle/internal/package-info.java b/src/main/java/net/openhft/chronicle/map/impl/package-info.java
similarity index 93%
rename from src/main/java/net/openhft/chronicle/internal/package-info.java
rename to src/main/java/net/openhft/chronicle/map/impl/package-info.java
index 0a3e8635b..193c09f7d 100644
--- a/src/main/java/net/openhft/chronicle/internal/package-info.java
+++ b/src/main/java/net/openhft/chronicle/map/impl/package-info.java
@@ -13,4 +13,4 @@
  * The classes in this package and any sub-package are subject to
  * changes at any time for any reason.
  */
-package net.openhft.chronicle.internal;
+package net.openhft.chronicle.map.impl;
diff --git a/src/main/java/net/openhft/chronicle/set/internal/package-info.java b/src/main/java/net/openhft/chronicle/set/internal/package-info.java
new file mode 100644
index 000000000..4b89a445e
--- /dev/null
+++ b/src/main/java/net/openhft/chronicle/set/internal/package-info.java
@@ -0,0 +1,16 @@
+/**
+ * This package and any and all sub-packages contains strictly internal classes for this Chronicle library.
+ * Internal classes shall <em>never</em> be used directly.
+ * <p>
+ *  Specifically, the following actions (including, but not limited to) are not allowed
+ *  on internal classes and packages:
+ *  <ul>
+ *      <li>Casting to</li>
+ *      <li>Reflection of any kind</li>
+ *      <li>Explicit Serialize/deserialize</li>
+ *  </ul>
+ * <p>
+ * The classes in this package and any sub-package are subject to
+ * changes at any time for any reason.
+ */
+package net.openhft.chronicle.set.internal;
diff --git a/src/main/java/net/openhft/xstream/converters/internal/package-info.java b/src/main/java/net/openhft/xstream/converters/internal/package-info.java
new file mode 100644
index 000000000..f759eae4f
--- /dev/null
+++ b/src/main/java/net/openhft/xstream/converters/internal/package-info.java
@@ -0,0 +1,16 @@
+/**
+ * This package and any and all sub-packages contains strictly internal classes for this Chronicle library.
+ * Internal classes shall <em>never</em> be used directly.
+ * <p>
+ *  Specifically, the following actions (including, but not limited to) are not allowed
+ *  on internal classes and packages:
+ *  <ul>
+ *      <li>Casting to</li>
+ *      <li>Reflection of any kind</li>
+ *      <li>Explicit Serialize/deserialize</li>
+ *  </ul>
+ * <p>
+ * The classes in this package and any sub-package are subject to
+ * changes at any time for any reason.
+ */
+package net.openhft.xstream.converters.internal;