← Back to issue list

chore: unshallow clone used in readthedocs

View original Github issue

Metadata

Project
rockcraft
Number
#706
Type
pull request
State
merged
Author
tigarmo
Labels
—
Created
Updated
Closed

Current evaluation

Merged PR #706 (commit f0d238c7) changed Read the Docs to unshallow the repository, letting git describe reach the older 1.5.3 tag and fixing sporadic docs build failures.

Resolution: closed resolved

Reason: PR #706 was merged as commit f0d238c7. It changed the RTD clone to include full history so git describe could locate tag 1.5.3.

Evaluated by: mr-cal-bot

No scores available.

Issue body

The readthedocs build started sporadically failing; what I *think* is happening is that the latest tag (1.5.3) is far enough from the HEAD of main (over 50 commits) that the previous command of fetching the tags was no longer sufficient to have "git describe" be able to reach the tag. - [ ] Have you signed the [CLA](http://www.ubuntu.com/legal/contributors/)? -----

Evaluation history

Date Model Scores Action Summary
stealth/space-bunny-alpha — closed resolved Merged PR #706 (commit f0d238c7) changed Read the Docs to unshallow the repository, letting git describe reach the older 1.5.3 tag and fixing sporadic docs build failures.
stealth/space-bunny-alpha — closed resolved Merged #706 (commit f0d238c7), unshallowing the Read the Docs checkout so git describe can reach older tags and stop sporadic build failures.
stealth/space-bunny-alpha — closed resolved Merged PR #706 in commit f0d238c7, making Read the Docs fetch tags from an unshallowed clone so git describe can reach older release tags.
stealth/space-bunny-alpha — closed resolved Merged PR #706, replacing the shallow Read the Docs clone with an unshallow clone so git describe can reach older tags and fix sporadic build failures.
stealth/space-bunny-alpha — closed resolved Merged PR #706 fixed intermittent Read the Docs failures by unshallowing the clone so git describe could reach distant tags, including 1.5.3.
qwen/qwen3.6-35b-a3b — — Merged to resolve sporadic readthedocs build failures. Switched to an unshallow clone so git describe can reach distant tags. Approved by two reviewers, passed CI, and modified three files.
qwen3.6-35b-a3b-mtp-q6 — — Merged a fix for sporadic readthedocs build failures. The change switches to an unshallow clone to resolve git describe failures when tags are over 50 commits behind main HEAD.

Update history

No update history recorded yet.

Related issues

Issue Project State Summary Similarity
#587 chore: point to correct readthedocs docs craft-providers merged Merged PR #587 in commit 34cab41 corrected Read the Docs links across two files, with four additions and one deletion.
74%
#556 chore(deps): update readthedocs environment craft-parts merged Merged PR #556 in commit 813733f7, updating the Read the Docs build environment after two approvals and with no unresolved review comments.
73%
#408 chore(docs): fix version in readthedocs build rockcraft merged Merged #408 via commit 6d3a85c6, fixing the version configuration used by the Read the Docs build.
72%
#267 chore: show example of truncated git clone craft-cli closed PR #267's documentation example for truncated git clone output was closed unmerged after prolonged inactivity; no resolving commit or merge was recorded.
71%