CI: docs-lint linkcheck times out reaching manpages.ubuntu.com
Metadata
Current evaluation
CI docs-lint linkcheck times out connecting to manpages.ubuntu.com; author suggests excluding the domain or adding retry/backoff. No maintainer response yet.
Suggested action: needs triage
Reason: The issue has no maintainer comments, no labels, and no assignee after 24 days. The author (a maintainer) already analyzed it as a transient flaky failure and suggested a fix (exclude manpages.ubuntu.com from linkcheck or add retry/backoff), but no one has acknowledged or acted on it. The current docs/conf.py already has linkcheck_retries=20 and linkcheck_report_timeouts_as_broken=False, but manpages.ubuntu.com is not in linkcheck_ignore, so the suggested fix is straightforward.
Impact:
50
Quick Win:
42.5
Staleness:
45
Complexity:
15
Confidence:
65
Support Request:
10
Issue body
## Summary
The `lint / files` check's `docs-lint` (Sphinx `linkcheck`) target failed on PR #238 due to a network timeout connecting to an external site, unrelated to that PR's content:
```
docs/explanation/cryptography.rst:16: WARNING: timeout https://manpages.ubuntu.com/manpages/noble/man8/dirmngr.8.html
HTTPSConnectionPool(host='manpages.ubuntu.com', port=443): Max retries exceeded with url: /manpages/noble/man8/dirmngr.8.html (Caused by ConnectTimeoutError(...))
make[1]: *** [Makefile:106: linkcheck] Error 1
make: *** [common.mk:355: docs-lint] Error 2
```
Run: https://github.com/canonical/craft-archives/actions/runs/29462390880/job/87508467518
## Notes
- This looks like a transient/flaky failure reaching `manpages.ubuntu.com`, not a broken link or a regression from the PR's changes — `Check policy`/`QA` runs on `main` around and after this date are green.
- If this recurs, consider adding a retry/backoff around `linkcheck`, or excluding `manpages.ubuntu.com` from strict linkcheck timeouts, since it's a third-party service outside this repo's control.
---
🤖 [BEEP BOOP, A BOT WROTE THIS COMMENT - Claude Sonnet 5, Copilot CLI]
Filed while investigating why the Starbase-merge PR #238 couldn't go green — the `docs-lint` failure is a network timeout to an external site, unrelated to that merge's content.
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen3.6-35b-a3b-mtp-q6 |
Impact:
50
Quick Win:
42.5
Staleness:
45
Complexity:
15
Confidence:
65
Support Request:
10
|
needs triage | CI docs-lint linkcheck times out connecting to manpages.ubuntu.com; author suggests excluding the domain or adding retry/backoff. No maintainer response yet. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
5
Complexity:
15
Confidence:
90
Support Request:
5
|
needs triage | CI docs-lint linkcheck fails due to transient network timeout to manpages.ubuntu.com. Unrelated to PR content, likely flaky. No maintainer response yet. |
Update history
| Date | Change |
|---|---|
| created |
Related issues
No related issues found above the similarity threshold.