docs(activity): add godoc for exported dual-series sparkline functions #303

Closed
opened 2026-07-07 09:42:24 +00:00 by the.auditor · 0 comments
Owner

Three exported functions in internal/activity/renderer.go lack doc comments:

  • DualBrailleSparkline — should document dual-series encoding (left/right columns), 5-level normalization, and empty/mismatched handling
  • PRSparkline — wraps DualBrailleSparkline with PrsOpened/PrsClosed
  • IssueSparkline — wraps DualBrailleSparkline with IssuesOpened/IssuesClosed

Also: brailleDualChar level-4 branches are unreachable due to normalize() 0-7 range being halved to 0-3 via /2. Consider either using 5-level normalization or removing dead code.

Ref: PR #302

Three exported functions in `internal/activity/renderer.go` lack doc comments: - `DualBrailleSparkline` — should document dual-series encoding (left/right columns), 5-level normalization, and empty/mismatched handling - `PRSparkline` — wraps DualBrailleSparkline with PrsOpened/PrsClosed - `IssueSparkline` — wraps DualBrailleSparkline with IssuesOpened/IssuesClosed Also: `brailleDualChar` level-4 branches are unreachable due to normalize() 0-7 range being halved to 0-3 via `/2`. Consider either using 5-level normalization or removing dead code. Ref: PR #302
fuzzy added this to the Steeper project 2026-07-07 09:42:57 +00:00
fuzzy self-assigned this 2026-07-07 09:42:58 +00:00
fuzzy closed this issue 2026-07-08 08:05:40 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
thwap/steeper#303
No description provided.