← Back to issue list

Docs: Demark links to Ops library

View original Github issue

Metadata

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

Current evaluation

Docs task to re-add 'Ops |' prefix to intersphinx links pointing to the Ops library. Partially done: many links now have the prefix, but some (e.g. manage-libraries.rst, configure-web-app-charm.rst) still lack it. No labels or maintainer triage; only bot comments. Author is a maintainer.

Suggested action: needs triage

Reason: The issue lacks labels, has no maintainer response (only two Jira-sync bot comments from 2025-01-17), and no assignee, meeting the needs_triage criteria. However, the problem is still live: grep shows 21 :external+ops:ref: hits, several without the 'Ops |' prefix (e.g. manage-libraries.rst:42, configure-web-app-charm.rst lines 40–127). Commits 'docs: align ops links formatting' (98a58a19, dbd6675f) suggest partial work was done, but the issue was never formally triaged or closed.

Impact: 15 Quick Win: 12.75 Staleness: 65 Complexity: 15 Confidence: 65 Support Request: 5

Issue body

### What needs to get done The links that point to the [Ops library](https://ops.readthedocs.io/en/latest/) use intersphinx (`:external+ops:ref:`). They lost their `Ops | [title]` marker in their link text during conversion. It ought to be re-added to each of them. ### Why it needs to get done Users need to know that the link is taking them to a separate doc set.

Evaluation history

Date Model Scores Action Summary
qwen/qwen3.8-27b
Impact: 15
Quick Win: 12.75
Staleness: 65
Complexity: 15
Confidence: 65
Support Request: 5
needs triage Docs task to re-add 'Ops |' prefix to intersphinx links pointing to the Ops library. Partially done: many links now have the prefix, but some (e.g. manage-libraries.rst, configure-web-app-charm.rst) still lack it. No labels or maintainer triage; only bot comments. Author is a maintainer.
qwen/qwen3.6-35b-a3b
Staleness: 85
Complexity: 15
Confidence: 80
Support Request: 10
needs triage Documentation intersphinx links to the Ops library lost their external link markers during conversion and need restoration. Currently unlabelled and inactive for over a year with no maintainer response.
qwen3.6-35b-a3b-mtp-q6
Staleness: 80
Complexity: 15
Confidence: 75
Support Request: 0
needs triage Documentation links to the Ops library via intersphinx lost their external marker during conversion and need restoration so users recognize them as external references. Currently unlabelled and inactive for over a year.
qwen3.6-35b-a3b-mtp-q6
Staleness: 85
Complexity: 10
Confidence: 75
Support Request: 5
close stale Intersphinx links to the Ops library lost their external markers during conversion and need restoration. The issue is unlabelled and has been inactive for over a year.
qwen3.6-35b-a3b-mtp-q6
Staleness: 75
Complexity: 10
Confidence: 85
Support Request: 0
needs triage Restore Ops library intersphinx link markers lost during documentation conversion. External links require clear markers so users recognize they leave the current doc set. The issue remains open and unassigned with no recent activity.

Update history

No update history recorded yet.

Related issues

No related issues found above the similarity threshold.