← Back to issue list

Add a description for `feature/<description>` branches

View original Github issue

Metadata

Project
starbase
Number
#323
Type
issue
State
open
Author
upils
Labels
Type: Documentation
Created
Updated
Closed
—

Current evaluation

Requests documenting the `feature/<description>` branch convention. HACKING.rst is now CONTRIBUTING.md, which documents `<ticket-id>-<description>` instead, so the gap is still open.

Suggested action: keep open

Reason: The gap is still real: CONTRIBUTING.md:162-165 (which replaced HACKING.rst in commit 3fe6515 / PR #365) documents branches as `<ticket-id>-<description>` and never mentions `feature/<description>`, while .github/workflows/qa.yaml:6 still gates CI on `feature/*`. No commit references #323, so it was not silently fixed. The issue is labeled `Type: Documentation` and was authored by a maintainer, so it is triaged and valid despite being 624 days old; a maintainer only needs to reconcile the two conventions, since the original request references a file that no longer exists.

Evaluated by: mr-cal-bot

Impact: 25 Quick Win: 13 Complexity: 20 Confidence: 78 Actionability: 65

Issue body

Our flow also relies on `feature/<description>` branches but usage of such branches is not explained in `HACKING.rst`.

Evaluation history

Date Model Scores Action Summary
stealth/space-bunny-alpha
Impact: 25
Quick Win: 13
Complexity: 20
Confidence: 78
Actionability: 65
keep open Requests documenting the `feature/<description>` branch convention. HACKING.rst is now CONTRIBUTING.md, which documents `<ticket-id>-<description>` instead, so the gap is still open.
qwen/qwen3.6-35b-a3b
Impact: 30
Quick Win: 22
Complexity: 10
Confidence: 70
Actionability: 80
keep open Documentation request to add feature/<description> branch workflow to HACKING.rst
qwen/qwen3.8-27b
Impact: 20
Quick Win: 18
Staleness: 80
Complexity: 10
Confidence: 65
Support Request: 10
close stale Docs gap: HACKING.rst does not explain the feature/<description> branch flow. Open 592 days with zero comments; merged PR #218 documents branch naming conventions, likely resolving it.
qwen/qwen3.6-35b-a3b
Staleness: 95
Complexity: 10
Confidence: 85
Support Request: 0
close stale Documentation gap regarding feature branch usage in HACKING.rst. Open for over 1.5 years with zero comments or maintainer engagement.
qwen3.6-35b-a3b-mtp-q6
Staleness: 92
Complexity: 10
Confidence: 88
Support Request: 0
close stale Request to document feature/<description> branch usage in HACKING.rst. Open for over 17 months with zero comments or maintainer interaction.

Update history

No update history recorded yet.

Related work

  • Related To: starbase#365 (confidence 75%)

    PR 'docs: convert repo docs to markdown' (commit 3fe6515) removed HACKING.rst in favour of CONTRIBUTING.md, so any fix must target the new file.

  • Related To: starbase#218 (confidence 70%)

    Merged PR 'docs(HACKING): document branch names and changelog' (commit 1acd270) documented branch naming but not the feature/<description> form.

Related issues

No related issues found above the similarity threshold.