[stable-2.17] Update unique filter docs (#84083)

* Correct case_sensitive example
* Add attribute docs

Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
(cherry picked from commit 18c6b40e19)

Co-authored-by: Tinyblargon <76069640+Tinyblargon@users.noreply.github.com>

lib/ansible/plugins/filter/unique.yml

@@ -10,6 +10,13 @@ DOCUMENTATION:
       description: A list.
       type: list
       required: true
+    case_sensitive:
+      description: Whether to consider case when comparing elements.
+      default: false
+      type: bool
+    attribute:
+      description: Filter objects with unique values for this attribute.
+      type: str
   seealso:
     - plugin_type: filter
       plugin: ansible.builtin.difference
@@ -24,6 +31,27 @@ EXAMPLES: |
   # list1: [1, 2, 5, 1, 3, 4, 10]
   {{ list1 | unique }}
   # => [1, 2, 5, 3, 4, 10]
+
+  # return case sensitive unique elements
+  {{ ['a', 'A', 'a'] | unique(case_sensitive='true') }}
+  # => ['a', 'A']
+
+  # return case insensitive unique elements
+  {{ ['b', 'B', 'b'] | unique() }}
+  # => ['b']
+
+  # return unique elements of list based on attribute
+  # => [{"age": 12, "name": "a" }, { "age": 14, "name": "b"}]
+  - debug:
+      msg: "{{ sample | unique(attribute='age') }}"
+    vars:
+      sample:
+        - name: a
+          age: 12
+        - name: b
+          age: 14
+        - name: c
+          age: 14
 RETURN:
   _value:
     description: A list with unique elements, also known as a set.