← Back to issue list

Docs how-to Spread tasks haven't run since #5440

View original Github issue

Metadata

Project
snapcraft
Number
#6532
Type
issue
State
open
Author
Deep-Axe
Labels
—
Created
Updated
Closed
—

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.