From f6536fe87b1ab6d417021a66e72ef68a53cd085f Mon Sep 17 00:00:00 2001
From: Nora Reidy <nora.reidy@mongodb.com>
Date: Fri, 11 Oct 2024 15:12:18 -0400
Subject: [PATCH] DOCSP-44158: Convert arrow to dot notation (#3173)

Adds information about dot and arrow notation conversion in v5.1
---
 docs/query-builder.txt | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/query-builder.txt b/docs/query-builder.txt
index 2bb6f75f2..cac12a368 100644
--- a/docs/query-builder.txt
+++ b/docs/query-builder.txt
@@ -221,6 +221,13 @@ value greater than ``8.5`` and a ``year`` value of less than
    :start-after: begin query andWhere
    :end-before: end query andWhere
 
+.. tip::
+
+   For compatibility with Laravel, Laravel MongoDB v5.1 supports both arrow
+   (``->``) and dot (``.``) notation to access nested fields in a query
+   filter. The preceding example uses dot notation to query the ``imdb.rating``
+   nested field, which is the recommended syntax.
+
 .. _laravel-query-builder-logical-not:
 
 Logical NOT Example