← Back to issue list

Docs: Update links to juju.is/docs

View original Github issue

Metadata

Project
charmcraft
Number
#2090
Type
issue
State
open
Author
medubelko
Labels
—
Created
Updated
Closed
—

Current evaluation

Update juju.is/docs links to canonical-juju.readthedocs-hosted.com; docs portion partially done via PRs, but many source-code links remain.

Suggested action: needs triage

Reason: The issue has no labels and only bot comments, so it has not been explicitly triaged by a human maintainer. Grep confirms numerous juju.is/docs URLs still exist in charmcraft source files and templates, while PRs #2095, #2136, #2350, and #2792 addressed only portions of the docs.

Evaluated by: mr-cal-bot

Impact: 35 Quick Win: 15 Complexity: 45 Confidence: 70 Actionability: 80

Issue body

### What needs to get done The main Juju docs are being migrated to https://canonical-juju.readthedocs-hosted.com/en/latest. The Juju site will redirect to them itself, but it's best not to link to a redirect. The Juju RTD docs are live as of this week, so we should be able to change all the links to them right away. ### Why it needs to get done The docs on the Discourse instance are being retired.

Evaluation history

Date Model Scores Action Summary
~deepseek/deepseek-pro-latest
Impact: 35
Quick Win: 15
Complexity: 45
Confidence: 70
Actionability: 80
needs triage Update juju.is/docs links to canonical-juju.readthedocs-hosted.com; docs portion partially done via PRs, but many source-code links remain.
qwen/qwen3.6-35b-a3b
Impact: 30
Quick Win: 19
Complexity: 20
Confidence: 85
Actionability: 80
keep open Update remaining juju.is/docs links to canonical-juju.readthedocs-hosted.com across the codebase. Previous partial fixes (#2095, #2136, #2792) merged but many links remain.
qwen/qwen3.8-27b
Impact: 25
Quick Win: 16
Staleness: 60
Complexity: 35
Confidence: 75
Support Request: 5
needs triage Update juju.is/docs links to new docs platform. Partially done via PRs #2095, #2136, #2792, but ~25 juju.is/docs links remain in Python source. Target URL has since shifted from RTD to documentation.ubuntu.com. No maintainer engagement beyond Jira bot.
qwen/qwen3.6-35b-a3b
Staleness: 85
Complexity: 5
Confidence: 80
Support Request: 0
needs triage Request to update documentation links from the retiring Discourse instance to the new ReadTheDocs host. Currently unlabelled and inactive for over 340 days.
qwen3.6-35b-a3b-mtp-q6
Staleness: 75
Complexity: 10
Confidence: 90
Support Request: 10
needs triage Request to update documentation links from retiring Discourse instance to new RTD URLs. Open, unlabelled, author is a maintainer, last human activity over 10 months ago, recently synced to Jira by bot.
qwen3.6-35b-a3b-mtp-q6
Staleness: 90
Complexity: 10
Confidence: 85
Support Request: 0
needs triage Request to update documentation links to the new Canonical Juju RTD host to avoid redirects, as Discourse docs are being retired. Unlabelled and inactive for over a year.

Update history

No update history recorded yet.

Related work

  • Related To: charmcraft#2095 (confidence 90%)

    Merged PR that updated Juju links and delivered the reStructuredText portion of this issue.

  • Related To: charmcraft#2136 (confidence 80%)

    Merged PR fixing six broken Juju references across four docs files.

  • Related To: charmcraft#2350 (confidence 80%)

    Merged PR fixing broken Juju docs links in the template CONTRIBUTING.md.

  • Related To: charmcraft#2792 (confidence 80%)

    Merged PR replacing broken Juju resource cross-references in two docs files.

Related issues

Issue Project State Summary Similarity
#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.
74%
#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.
72%
#6368 docs: update links snapcraft merged Merged PR #6368 updated six Ubuntu documentation links across two files, fixing CI linting; review was approved and all checks passed.
72%