Skip to content

[max7219digit] Fix incorrect action names in documentation#6131

Merged
ximex merged 1 commit intoesphome:currentfrom
swoboda1337:fix-max7219digit-action-names
Feb 20, 2026
Merged

[max7219digit] Fix incorrect action names in documentation#6131
ximex merged 1 commit intoesphome:currentfrom
swoboda1337:fix-max7219digit-action-names

Conversation

@swoboda1337
Copy link
Member

Description

The documented action names for the max7219digit component incorrectly used the MAX7219.* prefix (e.g. MAX7219.reverse_on, MAX7219.invert_on). The actual registered action names use the max7219digit.* prefix (e.g. max7219digit.reverse_on, max7219digit.invert_on).

This also fixes the heading levels for the reverse and intensity action sections which were ## instead of ### like the other action headings.

Related issue (if applicable): fixes esphome/esphome#14154

Pull request in esphome with YAML changes (if applicable):

  • N/A (note: there is also a typo in the code where actions are registered as max7129digit.* instead of max7219digit.* — that will need a separate esphome PR)

Checklist

  • I am merging into next because this is new documentation that has a matching pull-request in esphome as linked above.
    or

  • I am merging into current because this is a fix, change and/or adjustment in the current documentation and is not for a new component or feature.

  • Link added in /src/content/docs/components/index.mdx when creating new documents for new components or cookbook.

Copilot AI review requested due to automatic review settings February 20, 2026 19:43
@esphome esphome bot added the current label Feb 20, 2026
@swoboda1337 swoboda1337 requested a review from ximex February 20, 2026 19:43
@netlify
Copy link

netlify bot commented Feb 20, 2026

Deploy Preview for esphome ready!

Name Link
🔨 Latest commit acbde16
🔍 Latest deploy log https://app.netlify.com/projects/esphome/deploys/6998bb1dab30220008043712
😎 Deploy Preview https://deploy-preview-6131--esphome.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Fixes the max7219digit component documentation so the documented automation action names match the actual registered action prefix (max7219digit.*), and aligns the action section heading levels with the rest of the page.

Changes:

  • Replace incorrect MAX7219.* action names with max7219digit.*.
  • Change reverse and intensity action headings from ## to ###.
  • Minor wording adjustments in the actions section (e.g., “With these actions…”).

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 20, 2026

Warning

Rate limit exceeded

@swoboda1337 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 16 minutes and 52 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

Walkthrough

This PR corrects documentation for the MAX7219 digit display component by renaming action references from the incorrect MAX7219.* prefix to the correct max7219digit.* prefix throughout all action definitions and examples.

Changes

Cohort / File(s) Summary
MAX7219 Documentation
src/content/docs/components/display/max7219digit.mdx
Updated action section headings and references from MAX7219.* to max7219digit.* for all actions (invert_on/off, turn_on/off, reverse_on/off, intensity) to correct naming inconsistencies in public-facing documentation.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and accurately summarizes the main change: fixing incorrect action names in the max7219digit documentation from MAX7219.* to max7219digit.* prefix.
Description check ✅ Passed The description is directly related to the changeset, explaining the incorrect MAX7219.* prefix usage and the actual max7219digit.* prefix, plus heading level fixes.
Linked Issues check ✅ Passed The PR directly addresses issue #14154 by correcting the documented action names from MAX7219.* to max7219digit.*, resolving the 'Unable to find action' error users encountered.
Out of Scope Changes check ✅ Passed All changes are scoped to fixing the documented action names and heading levels in the max7219digit documentation, with no unrelated modifications present.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

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 and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Nitpick comments (1)
src/content/docs/components/display/max7219digit.mdx (1)

100-100: Nit: ambiguous phrasing in reverse-action description.

"from left to right to right to left" is hard to parse. Hyphens make the directional pairs unambiguous.

✏️ Proposed fix
-With these actions you can reverse the display direction from left to right to right to left.
+With these actions you can reverse the display direction from left-to-right to right-to-left.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/content/docs/components/display/max7219digit.mdx` at line 100, The
sentence in src/content/docs/components/display/max7219digit.mdx ("With these
actions you can reverse the display direction from left to right to right to
left.") is ambiguous; update it to use hyphenated directional pairs for
clarity—e.g. change the text to "With these actions you can reverse the display
direction from left-to-right to right-to-left." Locate and edit the line
containing that sentence in the Max7219Digit documentation and replace it with
the hyphenated version (left-to-right / right-to-left) to make the reversal
description unambiguous.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@src/content/docs/components/display/max7219digit.mdx`:
- Around line 88-104: Docs mention actions as max7219digit.* but the runtime
currently registers them as max7129digit.*; add a temporary MDX callout (using >
[!NOTE]) near the top of this section warning that users may need to use the
erroneous max7129digit.* action names until the esphome fix is released, list
both examples (e.g., max7219digit.reverse_on vs max7129digit.reverse_on),
reference issue `#14154` for context, and include a short TODO to remove the note
once the esphome-side PR is merged.
- Around line 106-107: The docs state the max7219digit action parameter
"intensity" as both Required and "Defaults to '15'"; remove the contradiction by
deleting the "Defaults to '15'." clause (or alternatively mark it optional and
keep the default) in the max7219digit.intensity parameter description in
src/content/docs/components/display/max7219digit.mdx so the documentation either
requires the caller to supply intensity or shows the default, but not both.

---

Nitpick comments:
In `@src/content/docs/components/display/max7219digit.mdx`:
- Line 100: The sentence in src/content/docs/components/display/max7219digit.mdx
("With these actions you can reverse the display direction from left to right to
right to left.") is ambiguous; update it to use hyphenated directional pairs for
clarity—e.g. change the text to "With these actions you can reverse the display
direction from left-to-right to right-to-left." Locate and edit the line
containing that sentence in the Max7219Digit documentation and replace it with
the hyphenated version (left-to-right / right-to-left) to make the reversal
description unambiguous.

@swoboda1337 swoboda1337 marked this pull request as draft February 20, 2026 19:47
@swoboda1337 swoboda1337 force-pushed the fix-max7219digit-action-names branch from 00cf327 to 117dd91 Compare February 20, 2026 19:48
The documented action names used `MAX7219.*` (e.g. `MAX7219.reverse_on`)
but the actual registered actions use the `max7219digit.*` prefix. Also
fix heading levels for reverse and intensity actions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@swoboda1337 swoboda1337 force-pushed the fix-max7219digit-action-names branch from 117dd91 to acbde16 Compare February 20, 2026 19:50
@swoboda1337 swoboda1337 marked this pull request as ready for review February 20, 2026 19:56
@ximex ximex merged commit 535a3af into esphome:current Feb 20, 2026
5 checks passed
@github-actions github-actions bot locked and limited conversation to collaborators Feb 22, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

max7219 inverting action doesn't work

3 participants