docs(lacrosse-scoreboard): document all 170 settings, with real renders

[ChuckBuilds]

The lacrosse README documented a fraction of the plugin's 170 settings and had no images. It now covers every schema leaf — verified with a token audit against config_schema.json — and shows the three men's display modes, both leagues side by side, the show_records toggle, and the live card at four panel sizes.

Structure

The ncaa_mens and ncaa_womens config blocks are identical in every setting except one: ncaa_mens defaults to enabled: true and ncaa_womens to false. Documenting a single <league> table rather than two byte-identical sets keeps 104 of the 170 leaves readable instead of duplicated, which is the point of the exercise.

What the old README did not say

• display_options.show_records and show_ranking default to true per league, while defaults.show_records and defaults.show_ranking default to false — and the per-league copy wins (manager.py:795, resolve_value). Because the web UI writes schema defaults on save, a saved config already carries the per-league true, so changing the defaults copy appears to do nothing. Documented in the settings reference and again under troubleshooting, where a user would actually look.
• The favorites key is teams.favorite_teams_only, not show_favorite_teams_only as in the single-league scoreboards, and it defaults to off here rather than on. Easy to carry the wrong key over from another scoreboard's config.
• other_games_min_quality is live in this plugin. NCAA lacrosse has a national poll to rank against, so its ranked default really does restrict non-favorite games — unlike in nrl, where the same setting is inert. other_games_divisions stays inert; it is a college football taxonomy.

mode_durations and customization.favorite_result_colors are read by the core (src/common/sports_card.py), not by this plugin. The README says where, so the next person does not delete them as dead.

Renders

From docs/assets/lacrosse-scoreboard/shots.json. Lacrosse differs from nrl: it keeps one manager per league and mode as a plain attribute (ncaa_mens_live, ncaa_womens_recent, …) rather than in a _managers dict, and only constructs them when that league's enabled flag is set — so the fixture turns both leagues on. These are real ESPN crests (Yale, Dartmouth, Quinnipiac, Harvard), not the grey placeholders nrl had.

One fixture correction worth noting: the switch-mode recent card reads game.get("period_text", "Final"), a .get default rather than a falsy check, so an empty-string period_text draws nothing. Real data never hits that — lacrosse.py:174 sets "Final" for any post-state game — so the fixture now carries what the extractor actually produces rather than an unreachable state.

Checks

• check_plugin.py: zero FAIL (16 checks; the harness exercises the men's recent and upcoming modes)
• Config-token audit: 170 schema leaves, 0 undocumented
• Every example config validated against the schema, including nesting depth and additionalProperties
• Every documented default read back from config_schema.json
• Manifest bumped 1.24.1 -> 1.24.2 (PATCH, docs-only), plugins.json regenerated by update_registry.py

Does not touch the shared sports.py lineage.

Dependency

Carries the docs-tooling commits from #423 so this branch renders standalone; identical in both branches and they collapse on merge.

🤖 Generated with Claude Code

[coderabbitai]

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: 48e2c48d-4bb7-4e14-85f9-47ed1fa317b3

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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

[codacy-production]

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

🟢 Metrics 18 complexity

Metric	Results
Complexity	18

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.}