Add note on logical operators (#4141)

* add note on logical operators

* Move logical operators note to DynamoDB conditions section header

Move the note about chaining conditions with logical operators (&, |, ~)
to appear directly under the "DynamoDB conditions" section header,
before the Key and Attr class documentation. This placement makes the
information more visible and clarifies that the operators apply to both
condition classes.

* added examples for each logical operator

* remove duplicate note

---------

Co-authored-by: veradri <veradri@amazon.com>

Author: tim-finnigan

docs/source/reference/customizations/dynamodb.rst

@@ -53,6 +53,25 @@ Custom Boto3 types
 DynamoDB conditions
 -------------------
 
+.. note::
+
+    Both :py:class:`~boto3.dynamodb.conditions.Key` and
+    :py:class:`~boto3.dynamodb.conditions.Attr` conditions can be chained
+    together using the logical operators: ``&`` (and), ``|`` (or), and ``~`` (not).
+
+    Example::
+
+        # Filter for users named 'John' who are over 25
+        FilterExpression=Attr('name').eq('John') & Attr('age').gt(25)
+
+        # Filter using OR
+        FilterExpression=Attr('status').eq('active') | Attr('role').eq('admin')
+
+        # Filter using NOT
+        FilterExpression=~Attr('deleted').eq(True)
+
+    See :ref:`dynamodb_guide` for more detailed usage examples.
+
 .. autoclass:: boto3.dynamodb.conditions.Key
    :members:
    :undoc-members:
@@ -61,4 +80,4 @@ DynamoDB conditions
 .. autoclass:: boto3.dynamodb.conditions.Attr
    :members:
    :undoc-members:
-   :inherited-members:
+   :inherited-members: