Skip to content

docs(ledmatrix-leaderboard): document all 56 settings, with real renders - #420

Open
ChuckBuilds wants to merge 1 commit into
mainfrom
docs/leaderboard-readme
Open

docs(ledmatrix-leaderboard): document all 56 settings, with real renders#420
ChuckBuilds wants to merge 1 commit into
mainfrom
docs/leaderboard-readme

Conversation

@ChuckBuilds

Copy link
Copy Markdown
Owner

What was missing

31 of the 56 settings had no named key — the whole global.appearance block, every per-league entry under enabled_sports, and most of the scroll tuning. All 56 are now documented at the paths the schema expects. additionalProperties is false, so a key at the wrong depth is rejected rather than ignored.

Three settings do nothing

global.scroll_speed_scale, global.scroll_direction and global.enable_scroll_metrics appear nowhere in the plugin, and nowhere in the core — including src/common/scroll_helper.py, which is where a scroll setting would plausibly be consumed rather than in the plugin itself. Marked in the README; I have not touched the schema.

The other 53 are all read by the plugin or the core.

The opening description overstated what appears

It said the plugin "shows team rankings, records, and statistics in a scrolling ticker format". Reading the renderer, each team is drawn as position number, logo, abbreviation — and the number text is:

return f"{index+1}."          # every league except ncaa_fb

For NCAA football, show_ranking chooses between the AP rank and record_summary. So a record reaches the panel in exactly one configuration, and no statistics do at all. The README now says that, with the two NCAA states pictured side by side:

#2 BUF versus 11-2 BUF.

Images

The ticker, text_outline and logo_scale, the NCAA show_ranking swap, and four panel sizes.

Two fixture notes now recorded in the shots file, both of which cost me a render cycle:

Checks

  • check_plugin.py: 8/8 pass
  • render_docs_assets.py --check: all four images reproduce
  • config-token audit: nothing dropped

Docs only. 1.3.2 → 1.3.3.

🤖 Generated with Claude Code

31 of the 56 had no named key -- the whole global.appearance block, every
per-league entry under enabled_sports, and most of the scroll tuning. All 56
are now documented at the paths the schema expects; additionalProperties is
false, so a key at the wrong depth is rejected rather than ignored.

Three do nothing: global.scroll_speed_scale, global.scroll_direction and
global.enable_scroll_metrics. They appear nowhere in the plugin, and nowhere
in the core -- including src/common/scroll_helper.py, which is where a scroll
setting would plausibly be consumed. Marked in the README; schema untouched.

Corrects the opening description. It said the plugin "shows team rankings,
records, and statistics", but each team is drawn as position number, logo and
abbreviation. Reading the renderer, the number text is f"{index+1}." for every
league except NCAA football, where show_ranking chooses between the AP rank
and record_summary. So a record reaches the panel in exactly one configuration,
and no statistics do.

Adds real rendered screenshots: the ticker, text_outline and logo_scale, the
NCAA show_ranking swap, and four panel sizes. Standings are seeded onto the
plugin instance; last_update has to be seeded too or update() re-fetches and
clears them, and the renderer reads record_summary rather than record -- my
first fixture used the latter and no records appeared.

check_plugin.py: 8/8 pass.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: 924aaf65-0a12-4568-a8d1-1acb2ca59f7a


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@codacy-production

Copy link
Copy Markdown

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant