docs: Add simple samples for custom grouping with task.id & task.blockedBy

Author: claremacrae

docs/Queries/Grouping.md

@@ -177,6 +177,17 @@ For more information, see [[Task Dependencies]].
 
 Since Tasks X.Y.Z, **[[Custom Grouping|custom grouping]] by Id** is now possible, using `task.id`.
 
+<!-- placeholder to force blank line before included text --><!-- include: CustomGroupingExamples.test.dependencies_task.id_docs.approved.md -->
+
+```javascript
+group by function task.id
+```
+
+- Group by task Ids, if any.
+- Note that currently there is no way to access any tasks that are blocked by these Ids.
+
+<!-- placeholder to force blank line after included text --><!-- endInclude -->
+
 ### Blocked By
 
 There is no built-in instruction to group by 'Blocked By'.
@@ -189,6 +200,18 @@ For more information, see [[Task Dependencies]].
 
 Since Tasks X.Y.Z, **[[Custom Grouping|custom grouping]]  by Blocked By** is now possible, using `task.blockedBy`.
 
+<!-- placeholder to force blank line before included text --><!-- include: CustomGroupingExamples.test.dependencies_task.blockedBy_docs.approved.md -->
+
+```javascript
+group by function task.blockedBy
+```
+
+- Group by the Ids of the tasks that this task depends on, if any.
+- If a task depends on more than one other task, it will be listed multiple times.
+- Note that currently there is no way to access the tasks being depended on.
+
+<!-- placeholder to force blank line after included text --><!-- endInclude -->
+
 ## Group by Dates in Tasks
 
 ### Due Date

tests/Scripting/ScriptingReference/CustomGrouping/CustomGroupingExamples.test.dependencies_task.blockedBy_docs.approved.md

@@ -0,0 +1,13 @@
+<!-- placeholder to force blank line before included text -->
+
+
+```javascript
+group by function task.blockedBy
+```
+
+- Group by the Ids of the tasks that each task depends on, if any.
+- If a task depends on more than one other task, it will be listed multiple times.
+- Note that currently there is no way to access the tasks being depended on.
+
+
+<!-- placeholder to force blank line after included text -->

tests/Scripting/ScriptingReference/CustomGrouping/CustomGroupingExamples.test.dependencies_task.blockedBy_results.approved.txt

@@ -0,0 +1,13 @@
+Results of custom groupers
+
+
+
+group by function task.blockedBy
+Group by the Ids of the tasks that each task depends on, if any.
+If a task depends on more than one other task, it will be listed multiple times.
+Note that currently there is no way to access the tasks being depended on.
+=>
+0h17ye
+dcf64c
+====================================================================================
+

tests/Scripting/ScriptingReference/CustomGrouping/CustomGroupingExamples.test.dependencies_task.id_docs.approved.md

@@ -0,0 +1,12 @@
+<!-- placeholder to force blank line before included text -->
+
+
+```javascript
+group by function task.id
+```
+
+- Group by task Ids, if any.
+- Note that currently there is no way to access any tasks that are blocked by these Ids.
+
+
+<!-- placeholder to force blank line after included text -->

tests/Scripting/ScriptingReference/CustomGrouping/CustomGroupingExamples.test.dependencies_task.id_results.approved.txt

@@ -0,0 +1,11 @@
+Results of custom groupers
+
+
+
+group by function task.id
+Group by task Ids, if any.
+Note that currently there is no way to access any tasks that are blocked by these Ids.
+=>
+dcf64c
+====================================================================================
+

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

@@ -26,6 +26,47 @@ afterEach(() => {
 
 // NEW_QUERY_INSTRUCTION_EDIT_REQUIRED
 
+describe('dependencies', () => {
+    const testData: CustomPropertyDocsTestData[] = [
+        // ---------------------------------------------------------------------------------
+        // DEPENDENCIES FIELDS
+        // ---------------------------------------------------------------------------------
+
+        [
+            'task.id',
+            [
+                [
+                    'group by function task.id',
+                    'Group by task Ids, if any.',
+                    'Note that currently there is no way to access any tasks that are blocked by these Ids.',
+                ],
+            ],
+            SampleTasks.withAllRepresentativeDependencyFields(),
+        ],
+
+        [
+            'task.blockedBy',
+            [
+                [
+                    'group by function task.blockedBy',
+                    'Group by the Ids of the tasks that each task depends on, if any',
+                    'If a task depends on more than one other task, it will be listed multiple times.',
+                    'Note that currently there is no way to access the tasks being depended on',
+                ],
+            ],
+            SampleTasks.withAllRepresentativeDependencyFields(),
+        ],
+    ];
+
+    it.each(testData)('%s results', (_: string, groups: QueryInstructionLineAndDescription[], tasks: Task[]) => {
+        verifyFunctionFieldGrouperSamplesOnTasks(groups, tasks);
+    });
+
+    it.each(testData)('%s docs', (_: string, groups: QueryInstructionLineAndDescription[], _tasks: Task[]) => {
+        verifyFunctionFieldGrouperSamplesForDocs(groups);
+    });
+});
+
 describe('dates', () => {
     const testData: CustomPropertyDocsTestData[] = [
         // ---------------------------------------------------------------------------------