← Back to issue list

Docs: Broken references to Juju

View original Github issue

Metadata

Project
charmcraft
Number
#2135
Type
issue
State
closed
Author
medubelko
Labels
—
Created
Updated
Closed

Current evaluation

Fixed by merged PR charmcraft#2136 in commit fe64df47, correcting six broken Juju documentation references across four files.

Resolution: closed resolved

Reason: Merged PR charmcraft#2136 resolved the reported make docs cross-reference warnings in commit fe64df47 by updating the broken Juju links.

Evaluated by: mr-cal-bot

No scores available.

Issue body

### Bug Description There are four references to Juju targets that are broken: ```output /dev/charmcraft/docs/howto/manage-bundles.rst:21: WARNING: external std:ref reference target not found: compare-and-export-the-contents-of-a-model-to-a-bundle /dev/charmcraft/docs/howto/manage-resources.rst:6: WARNING: external std:ref reference target not found: resource-charm /dev/charmcraft/docs/reference/files/bundle-yaml-file.rst:751: WARNING: external std:ref reference target not found: charm-documentation-best-practices /dev/charmcraft/docs/reference/files/charmcraft-yaml-file.rst:845: WARNING: external std:ref reference target not found: resource-charm ``` ### To Reproduce Run `make docs`. ### Environment - ### charmcraft.yaml ```yaml - ``` ### Relevant log output ```shell - ```

Evaluation history

Date Model Scores Action Summary
stealth/space-bunny-alpha — closed resolved Fixed by merged PR charmcraft#2136 in commit fe64df47, correcting six broken Juju documentation references across four files.
stealth/space-bunny-alpha — closed resolved Fixed by merged PR #2136 (commit fe64df47), which updated broken Juju documentation references across four files.
stealth/space-bunny-alpha — closed resolved Fixed broken Juju documentation cross-references by merging canonical/charmcraft#2136 in commit fe64df47.
stealth/space-bunny-alpha — closed stale Four broken Juju documentation cross-references were reported; no resolving PR, commit, or maintainer closure explanation is shown.
qwen/qwen3.6-35b-a3b — — Closed. Automated Jira tickets were created for tracking, but no explicit fix or resolution was documented.
qwen3.6-35b-a3b-mtp-q6
Staleness: 92
Complexity: 10
Confidence: 75
Support Request: 5
needs triage Documentation build fails with warnings for four broken external references to Juju targets. Unlabeled, no maintainer response, inactive for over a year.
qwen3.6-35b-a3b-mtp-q6
Staleness: 85
Complexity: 15
Confidence: 80
Support Request: 0
needs triage Documentation build fails with four broken external references to Juju targets. Issue is unlabelled and has seen no maintainer response in over a year.

Update history

Date Change
closed

Related work

  • Likely Fixed By: charmcraft#2136 (confidence 100%)

    The directly corresponding documentation-fix PR was merged as commit fe64df47.

Related issues

Issue Project State Summary Similarity
#2136 docs: fix broken references to juju docs charmcraft merged Merged in canonical/charmcraft#2136 (commit fe64df47), fixing six broken Juju documentation references across four docs files alongside juju/juju#18788 and #18790.
92%
#2095 docs: update Juju links charmcraft merged Merged in canonical/charmcraft#2095 (commit 389f8ca5), updating Juju links and related formatting across 16 files as the rST portion of #2090.
78%
#2792 Docs: replace broken Juju resource references charmcraft closed PR #2792 was closed unmerged after inactivity; no merge commit exists, and the affected files still contain the broken Juju external references.
76%
#1498 docs: Fix 404 in charmcraft.yaml.j2 charmcraft closed Merged in canonical/charmcraft#1498, correcting a broken charmcraft.yaml.j2 documentation link that returned 404.
75%
#2203 docs: copy best practices from Juju docs charmcraft merged Merged PR #2203 as commit 5bf5edc6, adding reviewed Juju-derived best practices as hint admonitions, mainly to the charmcraft.yaml reference.
74%
#2350 docs: fix broken link to Juju docs in template CONTRIBUTING.md charmcraft merged Merged PR #2350 updated two obsolete Juju development-setup links in the template CONTRIBUTING.md to their current documentation equivalents.
73%
#2752 Update links to canonical.com/juju/docs/ops and small doc string changes in kubernetes and machine profiles charmcraft closed Merged in canonical/charmcraft#2753 (commit 389d7dcb), updating Juju Ops links and clarifying charm fixture docstrings in init profiles on hotfix/4.3.
73%
#1341 [JUJU-4554] Update the README to simplify and better align with docs charmcraft merged Docs-only PR merged as commit 647a605c (#1341): rewrote Charmcraft's README (+62/-118) to a shorter intro placing Charmcraft in the Juju/Charm SDK ecosystem and linking to Charm SDK docs instead of Multipass install steps.
73%
#2299 docs: fix formatting issues charmcraft merged Merged docs formatting fixes for local documentation builds in charmcraft#2299 via commit 5ffb80fe; two files changed (+3/-1).
72%
#2186 docs: fix build errors charmcraft merged Merged as charmcraft/charmcraft#2186 in commit 42f42bd2, fixing the targeted docs build error. Remaining transclusion problems were addressed separately in canonical/craft-parts#1021.
72%