📝 [#472] update description of 'data_attrs' query param in the OAS

src/objects/api/v2/filters.py

@@ -77,6 +77,9 @@ class ObjectRecordFilterSet(FilterSet):
 Example: in order to display only objects with `height` equal to 100, query `data_attrs=height__exact__100`
 should be used. If `height` is nested inside `dimensions` attribute, query should look like
 `data_attrs=dimensions__height__exact__100`
+
+If you want to include comma to value part, use `\\,` to escape it, for example (with percentage encoding):
+`data_attrs=naam__icontains__Advies%%5C, support en kennis`
 """
         )
         % {"operator_choices": display_choice_values_for_help_text(Operators)},

src/objects/api/v2/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: Objects API
-  version: 2.4.3 (v2)
+  version: 2.4.3
   description: |
     An API to manage Objects.
 
@@ -114,6 +114,9 @@ paths:
           Example: in order to display only objects with `height` equal to 100, query `data_attrs=height__exact__100`
           should be used. If `height` is nested inside `dimensions` attribute, query should look like
           `data_attrs=dimensions__height__exact__100`
+
+          If you want to include comma to value part, use `\,` to escape it, for example (with percentage encoding):
+          `data_attrs=naam__icontains__Advies%5C, support en kennis`
       - in: query
         name: data_icontains
         schema:
@@ -641,6 +644,9 @@ paths:
                       Example: in order to display only objects with `height` equal to 100, query `data_attrs=height__exact__100`
                       should be used. If `height` is nested inside `dimensions` attribute, query should look like
                       `data_attrs=dimensions__height__exact__100`
+
+                      If you want to include comma to value part, use `\,` to escape it, for example (with percentage encoding):
+                      `data_attrs=naam__icontains__Advies%5C, support en kennis`
                   date:
                     type: string
                     format: date