SG-31392 Add doc for PublishedFiles preset filters (#292)

* SG-31392 Add doc for PublishedFiles preset filters

* SG-31392 grammar fixes

Author: dsauve-adsk

docs/reference.rst

@@ -545,9 +545,9 @@ with which parameters.
                 LATEST            [string] latest_by  'ENTITIES_CREATED_AT':
                                                         When dealing with multiple
                                                         Versions associated to a group
-                                                        of entities, returns only the
-                                                        last Version created for each
-                                                        entity.
+                                                        of entities, this will return
+                                                        only the last Version created
+                                                        for each entity.
                                                         For example, when dealing with a
                                                         set of Shots, this preset allows
                                                         to find the latest Version created
@@ -570,6 +570,23 @@ with which parameters.
                                                         will return the Version associated
                                                         to the Task with the highest
                                                         step.list_order value.
+    Published   LATEST            [string] latest_by  'ENTITIES_CREATED_AT':
+    Files                                               When dealing with multiple
+                                                        PublishedFiles associated to a
+                                                        group of entities, this will return
+                                                        only the last PublishedFiles created
+                                                        for each entity.
+                                                        For example, when dealing with a
+                                                        set of Versions, this preset allows
+                                                        you to find the latest PublishedFile
+                                                        created for each of these Versions.
+
+                                                      'VERSION_NUMBER':
+                                                        When dealing with multiple
+                                                        PublishedFiles associated with a
+                                                        group of entities, this returns only
+                                                        the PublishedFile with the highest
+                                                        version_number.
 
 .. _data_types: