← Back to issue list

docs: reference lifecycle details

View original Github issue

Metadata

Project
craft-parts
Number
#1053
Type
pull request
State
closed
Author
alesancor1
Labels
—
Created
Updated
Closed

Current evaluation

Docs PR adding lifecycle-step cross-references was closed unmerged by maintainers: cross-linking from the docs/common directory breaks downstream Sphinx builds and would revert #1162 (commit 89d51b16).

Resolution: closed superseded

Reason: Closed by maintainers medubelko and lengau on 2025-07-14, stating it would reverse the deliberate change made in merged PR #1162 (commit 89d51b16, 'docs: remove internal links in common directory'), which removed internal links from common docs pages to avoid Sphinx build failures in downstream apps.

Evaluated by: mr-cal-bot

No scores available.

Issue body

- [x] Have you signed the [CLA](http://www.ubuntu.com/legal/contributors/)? - [x] Have you added an entry to the changelog (`docs/reference/changelog.rst`)? ----- This PR adds references to the lifecycle docs page on every occurrence of <lifecycle step> ---- See [built page](https://canonical-craft-parts--1053.com.readthedocs.build/en/1053/)

Evaluation history

Date Model Scores Action Summary
stealth/space-bunny-alpha — closed superseded Docs PR adding lifecycle-step cross-references was closed unmerged by maintainers: cross-linking from the docs/common directory breaks downstream Sphinx builds and would revert #1162 (commit 89d51b16).
stealth/space-bunny-alpha — closed superseded Closed unmerged: broad lifecycle-doc cross-links would reverse the documentation structure established by #1162, which maintainers said caused problems.
qwen/qwen3.6-35b-a3b — — Documentation cross-linking changes were rejected and closed. Maintainers declined the update due to technical issues with the docs structure and because it would reverse a recent release change.
qwen3.6-35b-a3b-mtp-q6 — — Rejected and closed. Maintainers declined the documentation cross-linking changes due to build issues in the common directory and because they would reverse a recent release. The pull request was closed without merging.

Update history

No update history recorded yet.

Related work

  • Superseded By: canonical/craft-parts#1162 (confidence 95%)

    Merged PR that intentionally removed internal links from docs/common pages; this PR would revert it

  • Likely Fixed By: canonical/craft-parts#1162 (confidence 60%)

    Commit 89d51b16 already establishes the policy against common-directory cross-linking

Related issues

No related issues found above the similarity threshold.