Docs how-to Spread tasks haven't run since #5440
Metadata
Current evaluation
Spread tasks under docs/how-to/code/ stopped running after PR #5440 moved tasks to docs/how-to/code/crafting/. The suite needs a new entry to discover tasks.
Suggested action: keep open
Reason: Valid, actionable bug: PR #5440 (47574a240) moved Spread tasks to docs/how-to/code/crafting/ but spread.yaml still only references docs/how-to/code/, which now has no direct subdirectories with tasks. The reporter suggests adding docs/how-to/code/crafting/ as a suite, which is a clear, low-complexity fix.
Evaluated by: mr-cal-bot
Impact:
40
Quick Win:
29
Complexity:
15
Confidence:
85
Actionability:
85
Issue body
### Check existing issues
- [x] I've verified that this request isn't described by any existing issues.
### Request
#5440 (`docs: reorganise pages`, squash-merged as 47574a240) moved the how-to Spread tasks from `docs/how-to/code/{basic,components,components-organize}` to `docs/how-to/code/crafting/…`. Within that PR, the move happened in "docs: restore spread dirs" (453dfcf), which put the tasks back under the suite but one level too deep. Spread only discovers tasks that are direct subdirectories of a suite, so the `docs/how-to/code/` suite now runs no tasks. The CI docs job only runs `docs/tutorials/code/craft-a-snap`.
These tasks back `create-a-component.rst` through `literalinclude`, so the YAML and pack commands on that page haven't been tested since April 2025.
A possible fix is registering `docs/how-to/code/crafting/` as a suite in `spread.yaml`, which keeps the `literalinclude` paths unchanged.
### Document location
docs/how-to/crafting/create-a-component.rst
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b |
Impact:
40
Quick Win:
29
Complexity:
15
Confidence:
85
Actionability:
85
|
keep open | Spread tasks under docs/how-to/code/ stopped running after PR #5440 moved tasks to docs/how-to/code/crafting/. The suite needs a new entry to discover tasks. |
Update history
| Date | Change |
|---|---|
| updated | |
| created |
Related work
-
Caused By:
snapcraft#5440
(confidence 95%)
PR #5440 (commit 47574a240) reorganized docs and moved Spread tasks one level deeper, breaking task discovery.
Related issues
No related issues found above the similarity threshold.