From 90ec8c0684fa4814b3524cc3077eea78f961753b Mon Sep 17 00:00:00 2001 From: Mike Garde Date: Wed, 26 Aug 2026 12:06:18 -0400 Subject: [PATCH] docs: Clarify `includes` and `desc` behaviors - Explain that `includes` prevents direct command-line access. - Clarify that omitting `desc` hides a task from the list while keeping it callable. --- website/src/next/docs/reference/schema.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/website/src/next/docs/reference/schema.md b/website/src/next/docs/reference/schema.md index 471d981661..cc3b3e636b 100644 --- a/website/src/next/docs/reference/schema.md +++ b/website/src/next/docs/reference/schema.md @@ -278,7 +278,8 @@ includes: - **Type**: `bool` - **Default**: `false` -- **Description**: Hide included tasks from command line and `--list` +- **Description**: Makes a task inaccessible from the command line and hidden + from `--list`, restricting its execution to other tasks only. ```yaml includes: @@ -529,7 +530,9 @@ tasks: #### `desc` - **Type**: `string` -- **Description**: Short description shown in `--list` +- **Description**: Short description shown in `--list`. If omitted, the task + will not be listed in `--list`, but will remain publicly callable from the + command line. ```yaml tasks: