← Back to issue list

docs: app title isn't read in TOC

View original Github issue

Metadata

Project
starbase
Number
#532
Type
issue
State
open
Author
medubelko
Labels
Type: Documentation Type: Bug
Created
Updated
Closed
—

Current evaluation

Rockcraft docs TOC title falls back to 'dev' instead of the Git tag because the RTD runner can't resolve the package version. Filed by a maintainer with no comments; related version/title fixes (#588, #590) landed since.

Suggested action: needs triage

Reason: No maintainer has commented, labelled, or assigned this issue (0 comments, 115 days old), so it lacks triage. The version lines in docs/conf.py are still commented out, but commits #588 ('fix version in title') and #590 ('remove html_title') suggest the title/version handling was reworked, so it needs a maintainer to confirm whether the RTD version-resolution problem is still reproducible before closing or keeping open.

Impact: 30 Quick Win: 16.5 Staleness: 55 Complexity: 45 Confidence: 55 Support Request: 10

Issue body

## Situation In Rockcraft, the title in the TOC isn't reading the Git tag: <img width="25%" alt="Image" src="https://github.com/user-attachments/assets/6060099e-503a-40ac-b71d-4141649d88d1" /> The code falls back to `dev` only if the Python env can't find `snapcraft.__version__`. In the RTD runner, that value isn't available for unknown reasons. ## Request - Find out why the RTD env can't access a copy of the Rockcraft source. - Patch the problem if it's on the Starbase side.

Evaluation history

Date Model Scores Action Summary
qwen/qwen3.8-27b
Impact: 30
Quick Win: 16.5
Staleness: 55
Complexity: 45
Confidence: 55
Support Request: 10
needs triage Rockcraft docs TOC title falls back to 'dev' instead of the Git tag because the RTD runner can't resolve the package version. Filed by a maintainer with no comments; related version/title fixes (#588, #590) landed since.
qwen/qwen3.6-35b-a3b
Staleness: 60
Complexity: 30
Confidence: 85
Support Request: 10
needs triage Documentation build fails to read Git tag for app title in RTD environment, falling back to dev. Lacks maintainer response or assignment after 74 days.
qwen3.6-35b-a3b-mtp-q6
Staleness: 65
Complexity: 15
Confidence: 90
Support Request: 0
needs triage Documentation build fails to read Git tag for app title in TOC due to missing version info in ReadTheDocs environment. Open for 61 days with no maintainer response or activity.
qwen3.6-35b-a3b-mtp-q6
Staleness: 40
Complexity: 30
Confidence: 85
Support Request: 10
keep open RTD runner fails to access Rockcraft version info, causing the TOC title to fallback to dev instead of the Git tag. Open, unassigned, and awaiting investigation to determine if the fix belongs in Starbase or the RTD environment.

Update history

No update history recorded yet.

Related work

  • Likely Fixed By: starbase#588 (confidence 40%)

    Commit 'docs: fix version in title (#588)' directly targets the version-in-title behavior this issue describes.

  • Related To: starbase#590 (confidence 40%)

    Commit 'docs: remove html_title from config (#590)' reworked title configuration, related to the TOC title symptom.

Related issues

No related issues found above the similarity threshold.