diff --git a/docs/modules/clusters/pages/accessing-domain-objects.adoc b/docs/modules/clusters/pages/accessing-domain-objects.adoc
index b1d3beba3..18ba7364b 100644
--- a/docs/modules/clusters/pages/accessing-domain-objects.adoc
+++ b/docs/modules/clusters/pages/accessing-domain-objects.adoc
@@ -41,6 +41,12 @@ With the introduction of `GenericRecord`, User Code Deployment should be used on
 
 == Creating New Portable Objects
 
+CAUTION: 
+.Deprecation Notice for Portable Serialization
+====
+Portable Serialization has been deprecated. We recommend you use Compact Serialization as Portable Serialization will be removed as of version 7.0.
+====
+
 To create a `GenericRecord` object in portable format, use the `GenericRecordBuilder.portable()` method:
 
 [source,java]
@@ -74,6 +80,8 @@ GenericRecord namedRecord = GenericRecordBuilder.compact("employee")
 Note that there is no need to create a class definition, or a schema in this case. A schema will be created
 from the fields of the builder automatically.
 
+WARNING: Data mismatches can occur if you use both generic and specific Compact serializers. For example, the Compact Generic Record serializer, which is included with Hazelcast, writes variable size fields in alphabetic order based on the field name. To avoid potential mismatches in your data, write explicit variable size fields for Compact serializers in alphabetic order.
+
 == Adding and Changing Values in Domain Objects
 
 We have also added two convenience methods in `GenericRecord` for you to