devdocs/specs/core-list-graph-datatable-filtering-sorting-paging.txt

@@ -55,6 +55,10 @@ filter:{any:true/false,items:[
 	{op:"OPERATOR",value:One of an array of strings, single string or single value of any supported type, i.e. int, decimal, bool iso8601 date etc }
 	]}
 
+ID VALUE vs NAME VALUE
+    Some colums represent both an ID and a text name, in those cases if the operator is Equals or NotEquals and the "value" property of the filter is a number then it's a specific ID
+    Otherwise if it's a string it's always filtering by the display name instead
+
 AUTHORIZATION:
     Authorization is controlled via roles set on underlying DataList object itself
     We provide a DataList suitable for picklists with ANY role access and anything with sensitive info has it's DataList Required roles to higher level