CI: docs-lint linkcheck times out reaching manpages.ubuntu.com
Metadata
Current evaluation
Resolved docs-lint linkcheck timeout to manpages.ubuntu.com by adding 20 retries and non-fatal timeout reporting in CI.
Resolution: closed resolved
Reason: The flaky linkcheck timeout was mitigated by implementing 20 retries and non-fatal timeout reporting, preventing transient network errors from failing CI.
Evaluated by: mr-cal-bot
No scores available.
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 |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b | — | closed resolved | Resolved docs-lint linkcheck timeout to manpages.ubuntu.com by adding 20 retries and non-fatal timeout reporting in CI. | |
| stealth/space-bunny-alpha |
Impact:
42
Quick Win:
31
Complexity:
18
Confidence:
96
Actionability:
91
|
close resolved | Sphinx linkcheck’s external-site timeout is now mitigated with 20 retries and non-fatal timeout reporting; the flaky docs-lint CI failure is resolved. | |
| stealth/space-bunny-alpha |
Impact:
32
Quick Win:
24
Complexity:
20
Confidence:
96
Actionability:
94
|
close resolved | Sphinx linkcheck’s third-party timeout is mitigated: docs now use 20 retries and only fail on broken links, resolving the reported flaky docs-lint failure. | |
| qwen3.6-35b-a3b-mtp-q6 |
Impact:
50
Quick Win:
42
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 |
|---|---|
| closed | |
| created |
Related issues
No related issues found above the similarity threshold.