← Back to issue list

'prepare' and 'install' stanza are missing documentation

View original Launchpad issue

Metadata

Project
snapcraft (launchpad)
Number
#1663583
Type
issue
State
open
Author
~3v1n0
Labels
—
Created
Updated
Closed
—

Current evaluation

Legacy prepare/install part-stanza documentation request from 2017; current docs describe lifecycle overrides instead, leaving the reported syntax obsolete.

Suggested action: close stale

Reason: The request is explicitly about ``prepare:`` and ``install:``. In the current tree, ``docs/reference/snapcraft-yaml.rst`` lists ``override_pull``, ``override_build``, ``override_stage``, and ``override_prime`` but has no corresponding ``PartSpec prepare`` or ``PartSpec install`` fields, while ``docs/explanation/parts-lifecycle.rst`` directs users to ``override-<step-name>``; this is concrete evidence that the reported legacy syntax has been retired rather than representing an unfinished current-doc gap.

Evaluated by: mr-cal-bot

Impact: 25 Quick Win: 13 Complexity: 20 Confidence: 82 Actionability: 65

Issue body

In snapcraft docs (not just snapcraft.io, also in docs sbufolder of master git repo) there's no documentation about the 'install:' or 'prepare:'options

Evaluation history

Date Model Scores Action Summary
stealth/space-bunny-alpha
Impact: 25
Quick Win: 13
Complexity: 20
Confidence: 82
Actionability: 65
close stale Legacy prepare/install part-stanza documentation request from 2017; current docs describe lifecycle overrides instead, leaving the reported syntax obsolete.
stealth/space-bunny-alpha
Impact: 10
Quick Win: 8
Complexity: 5
Confidence: 84
Actionability: 86
close stale Legacy prepare/install stanza documentation request is stale: current lifecycle docs describe override-* hooks and CRAFT_PART_INSTALL, while the 2017 discussion referenced migrated Scriptlets documentation.
stealth/space-bunny-alpha
Impact: 15
Quick Win: 12
Complexity: 10
Confidence: 94
Actionability: 92
close stale Snapcraft's legacy install and prepare part stanzas are undocumented, but current craft-parts has removed them and documents override-* scriptlets instead, leaving this report obsolete.
qwen/qwen3.6-35b-a3b
Impact: 30
Quick Win: 14
Complexity: 20
Confidence: 60
Actionability: 60
needs triage Documentation gap for snapcraft's prepare: and install: stanzas; open ~10 years with no maintainer response or labels
qwen/qwen3.8-27b
Impact: 10
Quick Win: 9
Staleness: 95
Complexity: 10
Confidence: 65
Support Request: 20
close stale Missing docs for 'prepare:' and 'install:' part stanzas in snapcraft. Open since 2016 with zero interaction; these stanzas belonged to the old snapcraft 1.x parts system, completely rewritten in 2.x.
qwen/qwen3.6-35b-a3b
Staleness: 98
Complexity: 15
Confidence: 85
Support Request: 10
close stale Missing documentation for 'prepare' and 'install' stanzas in snapcraft. Open for nearly 10 years with zero maintainer interaction or comments.
qwen/qwen3.6-35b-a3b
Staleness: 98
Complexity: 15
Confidence: 95
Support Request: 10
close stale Missing documentation for the prepare and install stanzas in snapcraft. The issue has been inactive for over 9 years with no maintainer response or comments.
qwen3.6-35b-a3b-mtp-q6
Staleness: 100
Complexity: 10
Confidence: 90
Support Request: 25
close stale Missing documentation for 'prepare' and 'install' stanzas in snapcraft. Issue remains completely inactive after ~9.4 years with no maintainer response, labels, or assignee.

Update history

Date Change
created

Related issues

No related issues found above the similarity threshold.