← Back to issue list

Create a basic how-to for using craft-platforms

View original Github issue

Metadata

Project
craft-platforms
Number
#87
Type
issue
State
open
Author
lengau
Labels
Type: Enhancement Status: Triaged Type: Documentation
Created
Updated
Closed
—

Current evaluation

Maintainer-filed request for a basic how-to guide on generating build plans with craft-platforms; still unwritten — docs/how-to/index.rst has an empty toctree and the quadrant is excluded from the Sphinx build. Triaged and open.

Suggested action: keep open

Reason: The request is valid and still unfulfilled: docs/how-to/index.rst has an empty toctree with no pages, and docs/index.rst only references reference/index and explanation/index, so the how-to quadrant is not in the published build. Git history for docs/how-to shows only scaffolding commits (337c743, 50567fc, fafd1fc), none adding content, and the only comments are bot Jira syncs (CRAFT-3868/3869/3870) with no resolution. Impact is moderate rather than high because the README already carries a working get_build_plan example and the issue is scoped as explicitly 'fairly short', though maintainer lengau notes it is needed 'before they fully utilise it' by the Launchpad team.

Evaluated by: mr-cal-bot

Impact: 35 Quick Win: 18 Complexity: 25 Confidence: 86 Actionability: 68

Issue body

Create a how-to for users describing how to use craft-platforms to generate build plans for various crafts. This can probably be fairly short as our primary users here will be the Launchpad team, but that also means we need it available before they fully utilise it. We should get someone from Launchpad to review this when we implement it.

Evaluation history

Date Model Scores Action Summary
stealth/space-bunny-alpha
Impact: 35
Quick Win: 18
Complexity: 25
Confidence: 86
Actionability: 68
keep open Maintainer-filed request for a basic how-to guide on generating build plans with craft-platforms; still unwritten — docs/how-to/index.rst has an empty toctree and the quadrant is excluded from the Sphinx build. Triaged and open.
stealth/space-bunny-alpha
Impact: 42
Quick Win: 17
Complexity: 25
Confidence: 85
Actionability: 55
keep open Maintainer-requested basic how-to guide for users of craft-platforms. Still open after 633 days; docs/how-to/ remains an empty toctree excluded in conf.py as an 'empty quadrant'.
stealth/space-bunny-alpha
Impact: 42
Quick Win: 22
Complexity: 28
Confidence: 88
Actionability: 72
keep open Maintainer-filed, triaged documentation request for a basic how-to showing users how to use craft-platforms to generate build plans for various crafts; still unwritten — docs/how-to/ remains an empty quadrant excluded from the Sphinx build.
stealth/space-bunny-alpha
Impact: 44
Quick Win: 29
Complexity: 24
Confidence: 88
Actionability: 88
keep open A basic how-to for generating build plans with craft-platforms remains open and triaged for documentation. It is needed to support Launchpad adoption, with Launchpad review requested.
stealth/space-bunny-alpha
Impact: 45
Quick Win: 32
Complexity: 18
Confidence: 96
Actionability: 87
keep open Missing user how-to for generating craft-platforms build plans; triaged documentation enhancement awaiting implementation and Launchpad review.
qwen3.6-35b-a3b-mtp-q6
Impact: 40
Quick Win: 32
Staleness: 85
Complexity: 20
Confidence: 75
Support Request: 10
close stale Documentation enhancement to create a how-to guide for using craft-platforms. Triaged but inactive for 605 days with only automated Jira sync comments.
qwen/qwen3.6-35b-a3b
Staleness: 85
Complexity: 20
Confidence: 80
Support Request: 0
keep open Issue requests creating a basic how-to guide for using craft-platforms to generate build plans. It is labeled as documentation and triaged, but has been inactive for over a year with no further progress.
qwen3.6-35b-a3b-mtp-q6
Staleness: 90
Complexity: 10
Confidence: 85
Support Request: 0
close stale Documentation enhancement requesting a how-to guide for craft-platforms build plans. Triaged but inactive for 548 days with no implementation progress.

Update history

No update history recorded yet.

Related issues

No related issues found above the similarity threshold.