diff --git a/reference/oci8/functions/oci-set-edition.xml b/reference/oci8/functions/oci-set-edition.xml
index 0c44b5c72c..0efbbff0a1 100644
--- a/reference/oci8/functions/oci-set-edition.xml
+++ b/reference/oci8/functions/oci-set-edition.xml
@@ -69,6 +69,17 @@
     SESSION SET EDITION to change the edition on persistent connections.
    </para>
   </caution>
+  <caution>
+   <title>DRCP Connection Pooling</title>
+   <para>
+    To avoid inconsistencies and unexpected errors when using editions
+    and <link linkend="oci8.connection">DRCP</link> with Oracle
+    11.2.0.1, keep a one-to-one correspondence between
+    the <link linkend="ini.oci8.connection.class">oci8.connection_class</link>
+    and the edition name used by applications.  Each pooled server of
+    a given connection class should only be used with one edition.
+   </para>
+  </caution>
  </refsect1>
 
  <refsect1 role="returnvalues">