diff --git a/source/fundamentals/data-formats/document-data-format-data-class.txt b/source/fundamentals/data-formats/document-data-format-data-class.txt index 6e0d3877..2a7171fd 100644 --- a/source/fundamentals/data-formats/document-data-format-data-class.txt +++ b/source/fundamentals/data-formats/document-data-format-data-class.txt @@ -99,7 +99,7 @@ You can use the following annotations on data classes: .. list-table:: :header-rows: 1 :stub-columns: 1 - :widths: 10 10 + :widths: 30 70 * - Annotation Name - Description @@ -112,8 +112,15 @@ You can use the following annotations on data classes: field to BSON. * - ``BsonRepresentation`` - - Specifies the BSON type used to store the value when different from the - data class property. + - Specifies the BSON type MongoDB uses to store the value. Use this + annotation only when you need to store a value as a different + BSON type than the data class property. + + .. warning:: + + Your code might throw an exception if you include the + ``BsonRepresentation`` annotation on a property that you store + as the same type as the data class property. For reference information on these property annotations, refer to the `org.bson.codecs.pojo.annotations <{+api+}/apidocs/bson/org/bson/codecs/pojo/annotations/package-summary.html>`__