← Back to issue list

Smarter docs URL handling

View original Github issue

Metadata

Project
craft-application
Number
#301
Type
issue
State
open
Author
lengau
Labels
Created
Updated
Closed

Current evaluation

Feature request to make docs URL handling smarter: when an error carries a docs slug, match it against the application's docs base URL so libraries can raise exceptions without the app catching/reraising them with a full docs URL. Tracked internally as CRAFT-2704; no maintainer response yet.

Suggested action: needs triage

Reason: The issue has no labels, no assignee, and the only comment is an automated Jira-sync bot message (CRAFT-2704) — no maintainer has acknowledged, categorised, or responded to it. The body itself notes it 'will probably initially need to be a spike', so it is an unassessed feature request that needs triage. The codebase already has partial infrastructure (doc_slug on errors, render_doc_url, docs_base_url on the dispatcher), suggesting the work is partially underway but not tied to this issue.

Impact: 45 Quick Win: 27.0 Staleness: 55 Complexity: 40 Confidence: 55 Support Request: 10

Issue body

### What needs to get done If the docs URL is a slug or something, match it to the application's docs and put that in. This will probably initially need to be a spike ### Why it needs to get done To let libraries raise exceptions without the application having to catch and reraise them with a docs URL (Suggested by @sergiusens )

Evaluation history

Date Model Scores Action Summary
qwen/qwen3.8-27b
Impact: 45
Quick Win: 27.0
Staleness: 55
Complexity: 40
Confidence: 55
Support Request: 10
needs triage Feature request to make docs URL handling smarter: when an error carries a docs slug, match it against the application's docs base URL so libraries can raise exceptions without the app catching/reraising them with a full docs URL. Tracked internally as CRAFT-2704; no maintainer response yet.
qwen/qwen3.6-35b-a3b
Staleness: 85
Complexity: 40
Confidence: 75
Support Request: 10
needs triage Feature request to automatically resolve documentation slugs to full URLs, allowing libraries to raise exceptions with embedded docs links. Currently untriaged and inactive for over a year.
qwen3.6-35b-a3b-mtp-q6
Staleness: 80
Complexity: 50
Confidence: 75
Support Request: 10
needs triage Feature request to automatically resolve documentation slugs to full URLs for library exceptions. Currently unlabelled, inactive for over a year, and lacks maintainer assessment.
qwen3.6-35b-a3b-mtp-q6
Staleness: 85
Complexity: 40
Confidence: 75
Support Request: 10
close stale Automatically resolve documentation slugs to full URLs, allowing libraries to raise exceptions directly. Currently open and awaiting an initial technical spike. Internal Jira ticket created. Inactive for over a year.

Update history

No update history recorded yet.

Related issues

No related issues found above the similarity threshold.