@@ -36,6 +36,11 @@ data Size a
36-- deserializes the boxed type from the mutable byte array. The write operation
36-- deserializes the boxed type from the mutable byte array. The write operation
37-- 'serialize' serializes the boxed type to the mutable byte array.
37-- 'serialize' serializes the boxed type to the mutable byte array.
39+-- IMPORTANT: The serialized data's byte ordering is not normalized, which means
40+-- it remains the same as the machine's byte order where the function is
41+-- executed. Consequently, it may not be compatible across machines with
42+-- different byte ordering.
39-- 'Serialize' contains enough information to serialize and deserialize variable
44-- 'Serialize' contains enough information to serialize and deserialize variable
40-- length types.
45-- length types.