test: - Add a new docs example, showing floating-point group names

Author: claremacrae

tests/Scripting/ScriptingReference/CustomGrouping/CustomGroupingExamples.test.other_properties_task.urgency_docs.approved.md

@@ -7,5 +7,14 @@ group by function task.urgency.toFixed(3)
 
 - Show the urgency to 3 decimal places, unlike the built-in "group by urgency" which uses 2.
 
+```javascript
+group by function task.urgency
+```
+
+- Show non-integer urgency values to 5 decimal places, and integer ones to 0 decimal places.
+- Sorting of groups by name has been found to be unreliable with varying numbers of decimal places.
+- So to ensure consistent sorting, Tasks will round non-integer numbers to a fixed 5 decimal places, returning the value as a string.
+- This still sorts consistently even when some of the group's values are integers.
+
 
 <!-- placeholder to force blank line after included text -->

tests/Scripting/ScriptingReference/CustomGrouping/CustomGroupingExamples.test.other_properties_task.urgency_results.approved.txt

@@ -13,3 +13,18 @@ Show the urgency to 3 decimal places, unlike the built-in "group by urgency" whi
 9.000
 ====================================================================================
 
+
+group by function task.urgency
+Show non-integer urgency values to 5 decimal places, and integer ones to 0 decimal places.
+Sorting of groups by name has been found to be unreliable with varying numbers of decimal places.
+So to ensure consistent sorting, Tasks will round non-integer numbers to a fixed 5 decimal places, returning the value as a string.
+This still sorts consistently even when some of the group's values are integers.
+=>
+-1.80000
+0
+1.95000
+3.90000
+6
+9
+====================================================================================
+

tests/Scripting/ScriptingReference/CustomGrouping/CustomGroupingExamples.test.ts

@@ -704,6 +704,13 @@ describe('other properties', () => {
                     'group by function task.urgency.toFixed(3)',
                     'Show the urgency to 3 decimal places, unlike the built-in "group by urgency" which uses 2',
                 ],
+                [
+                    'group by function task.urgency',
+                    'Show non-integer urgency values to 5 decimal places, and integer ones to 0 decimal places',
+                    'Sorting of groups by name has been found to be unreliable with varying numbers of decimal places.',
+                    'So to ensure consistent sorting, Tasks will round non-integer numbers to a fixed 5 decimal places, returning the value as a string.',
+                    "This still sorts consistently even when some of the group's values are integers.",
+                ],
             ],
             SampleTasks.withAllPriorities(),
         ],