-
Notifications
You must be signed in to change notification settings - Fork 7.2k
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
Add 'always use new connection' configuration option to Enphase Envoy docs #35083
base: next
Are you sure you want to change the base?
Conversation
📝 WalkthroughWalkthroughThe changes involve updates to the documentation for the Enphase Envoy integration in Home Assistant. A new configuration option has been introduced, allowing users to opt for a new connection when requesting data from the Envoy, aimed at resolving connection issues with older firmware. The documentation has been refined for clarity, with expanded descriptions of sensors and switches, and a restructured section on polling intervals for better user guidance. Changes
Sequence Diagram(s)sequenceDiagram
participant User
participant HomeAssistant
participant Envoy
User->>HomeAssistant: Configure Enphase Envoy integration
HomeAssistant->>Envoy: Request data (new connection option)
Envoy-->>HomeAssistant: Send data
HomeAssistant-->>User: Display data
Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media? 🪧 TipsChatThere are 3 ways to chat with CodeRabbit:
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 (
|
✅ Deploy Preview for home-assistant-docs ready!
To edit notification comments on pull requests, go to your Netlify site configuration. |
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
🧹 Outside diff range and nitpick comments (2)
source/_integrations/enphase_envoy.markdown (2)
143-144
: LGTM! Consider a minor clarification.The new configuration option is well-documented and addresses a specific issue with older firmware versions. It's a valuable addition to the integration's configuration options.
To enhance clarity, consider adding a brief note about the default behavior:
- Always use a new connection when requesting data from the Envoy - No/Yes + Always use a new connection when requesting data from the Envoy - No/Yes (Default: No)This addition would make it immediately clear to users what the default setting is without having to read the full description.
🧰 Tools
🪛 LanguageTool
[grammar] ~144-~144: Articles like ‘the’ are rarely followed by punctuation. A word may be missing after ‘the’, or the punctuation mark may not be necessary.
Context: ...ay exhibit connection issues when using the, by default enabled, keep-alive connecti...(THE_PUNCT)
144-144
: Improve readability by rephrasing the sentence.The current sentence structure, while grammatically correct, might be slightly confusing due to the parenthetical phrase. Consider rephrasing for better clarity:
- Some older Envoy firmware may exhibit connection issues when using the, by default enabled, keep-alive connection and report failures. + Some older Envoy firmware may exhibit connection issues when using the keep-alive connection (enabled by default) and report failures.This rephrasing maintains the original meaning while improving readability.
🧰 Tools
🪛 LanguageTool
[grammar] ~144-~144: Articles like ‘the’ are rarely followed by punctuation. A word may be missing after ‘the’, or the punctuation mark may not be necessary.
Context: ...ay exhibit connection issues when using the, by default enabled, keep-alive connecti...(THE_PUNCT)
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
📒 Files selected for processing (1)
- source/_integrations/enphase_envoy.markdown (1 hunks)
🧰 Additional context used
🪛 LanguageTool
source/_integrations/enphase_envoy.markdown
[grammar] ~144-~144: Articles like ‘the’ are rarely followed by punctuation. A word may be missing after ‘the’, or the punctuation mark may not be necessary.
Context: ...ay exhibit connection issues when using the, by default enabled, keep-alive connecti...(THE_PUNCT)
Proposed change
To fix a bug in the Enphase Envoy integration data collection, a configuration item has been added. The configuration item enables the use to disable keep-alive on connection to the Envoy.
This PR adds the description of the new configuration option to the Enphase Envoy documentation:
Type of change
current
branch).current
branch).next
branch).next
branch).Additional information
Checklist
current
branch.next
branch.Summary by CodeRabbit
New Features
Documentation