-
-
Notifications
You must be signed in to change notification settings - Fork 2k
[key_collector] refrence SX1509 keypad engine #5087
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: current
Are you sure you want to change the base?
Conversation
""" WalkthroughThe documentation for the Changes
Sequence Diagram(s)No sequence diagram generated as the changes are limited to documentation updates. 📜 Recent review detailsConfiguration used: CodeRabbit UI ⛔ Files ignored due to path filters (1)
📒 Files selected for processing (1)
✅ Files skipped from review due to trivial changes (1)
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. 🪧 TipsChatThere are 3 ways to chat with CodeRabbit:
SupportNeed help? Create a ticket on our support page for assistance with any issues or questions. Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments. CodeRabbit Commands (Invoked using PR comments)
Other keywords and placeholders
CodeRabbit Configuration File (
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Actionable comments posted: 0
🧹 Nitpick comments (3)
components/key_collector.rst (3)
10-13
: Use a consistent Sphinx role for component cross-references
matrix_keypad
is referenced with:ref:
while the other components in the same sentence use:doc:
. Mixing the two roles in a single enumeration is visually jarring and may break if the target anchor formatrix_keypad
is ever renamed. Prefer:doc:
everywhere for uniformity and resilience.-like :ref:`matrix_keypad`, :doc:`Wiegand keypad </components/wiegand>`, -:doc:`SX1509 keypad engine </components/sx1509>`, +like :doc:`Matrix Keypad </components/matrix_keypad>`, +:doc:`Wiegand keypad </components/wiegand>`, +:doc:`SX1509 keypad engine </components/sx1509>`,
14-16
: Minor wording tweak for brevityThe leading comma after “as one,” is slightly awkward. Replacing the clause with “as a single sequence” is a bit crisper.
No diff supplied to avoid shifting line numbers; feel free to adjust if you agree.
56-58
: Fix typo “witout” → “without”-which the sequence will trigger the ``on_result`` automation witout having to press any of the ``end_keys`` +which the sequence will trigger the ``on_result`` automation without having to press any of the ``end_keys``
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (1)
components/key_collector.rst
(2 hunks)
🧰 Additional context used
📓 Path-based instructions (1)
**
Instructions used from:
Sources:
⚙️ CodeRabbit Configuration File
🧠 Learnings (1)
📓 Common learnings
Learnt from: jesserockz
PR: esphome/esphome-docs#4865
File: .github/workflows/needs-docs.yml:0-0
Timestamp: 2025-05-01T03:29:47.922Z
Learning: In the esphome-docs repository, the "current" label is automatically added by a bot to pull requests, making it a reliable indicator for the target branch.
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
- GitHub Check: build
🔇 Additional comments (1)
components/key_collector.rst (1)
121-125
: Addition looks goodThe new “See Also” link correctly points users to the SX1509 keypad engine documentation and rounds out the cross-references section.
✅ Deploy Preview for esphome ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
There's no reason for the key collector to not be added to the top level. Originally it was only useful with a specific component, so it was only accessible from there. You can add it if you want. |
…s are public/private keys that aren't supposed to be typed out
Description:
Expanding on #4756 which did the opposite (referenced
key_collector
inSX1509
)NOTE:
key_collector
is NOT in/components/index.rst
, though it's not a new component, and I'm not sure if there's a reason it's not I'm unaware of? So haven't added it.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
/components/index.rst
when creating new documents for new components or cookbook.