diff --git a/source/reference/object-id.txt b/source/reference/object-id.txt index 53294f7ac27..633a8a5ab9d 100644 --- a/source/reference/object-id.txt +++ b/source/reference/object-id.txt @@ -30,9 +30,16 @@ additional benefits: ` method. - sorting on an ``_id`` field that stores ``ObjectId`` values is - roughly equivalent to sorting by creation time, although this - relationship is not strict with ``ObjectId`` values generated on - multiple systems within a single second. + roughly equivalent to sorting by creation time. + + .. warning:: + + This relationship is not strict with ``ObjectId`` values + generated within a single second. This can happen if the + values are generated by multiple systems within a second, + or as a result of clock skew on the client side, which + would result in non-strict behavior even for entries that + are multiple seconds apart. Also consider the :doc:`/core/document/` section for related information on MongoDB's document orientation.