Skip to content

Add WattWächter Plus integration docs#44004

Open
smartcircuits wants to merge 7 commits intohome-assistant:nextfrom
SmartCircuits-GmbH:add-wattwaechter-docs
Open

Add WattWächter Plus integration docs#44004
smartcircuits wants to merge 7 commits intohome-assistant:nextfrom
SmartCircuits-GmbH:add-wattwaechter-docs

Conversation

@smartcircuits
Copy link
Copy Markdown

@smartcircuits smartcircuits commented Mar 9, 2026

Proposed change

Add documentation for the new WattWächter Plus integration. The WattWächter Plus is a local energy monitoring device that reads smart meter data via SML/OBIS and exposes it over a local HTTP API.

Type of change

  • Spelling, grammar or other readability improvements (current branch).
  • Adjusted missing or incorrect information in the current documentation (current branch).
  • Added documentation for a new integration I'm adding to Home Assistant (next branch).
    • Brand assets are included in the integration directory (no separate brands PR needed since 2026.03).
  • Added documentation for a new feature I'm adding to Home Assistant (next branch).
  • Removed stale or deprecated documentation.

Additional information

Checklist

  • This PR uses the correct branch, based on one of the following:
    • I made a change that is related to an upcoming version of Home Assistant and used the next branch.
  • The documentation follows the Home Assistant documentation standards.

Copilot AI review requested due to automatic review settings March 9, 2026 23:33
@home-assistant home-assistant bot added current This PR goes into the current branch has-parent This PR has a parent PR in another repo in-progress This PR/Issue is currently being worked on needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch labels Mar 9, 2026
@home-assistant
Copy link
Copy Markdown

home-assistant bot commented Mar 9, 2026

It seems that this PR is targeted against an incorrect branch since it has a parent PR on one of our codebases. Documentation that needs to be updated for an upcoming release should target the next branch. Please change the target branch of this PR to next and rebase if needed.

@netlify
Copy link
Copy Markdown

netlify bot commented Mar 9, 2026

Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit 1370d91
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/69dbafc0f16d320008f96939
😎 Deploy Preview https://deploy-preview-44004--home-assistant-docs.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
Copy Markdown
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

Adds a new integration documentation page for the upcoming WattWächter Plus integration, describing setup, supported entities, options, troubleshooting, and examples for Home Assistant users.

Changes:

  • Introduces a new source/_integrations/wattwaechter.markdown integration doc page with prerequisites, config flow info, and supported functionality.
  • Documents options (polling interval), firmware update behavior, and troubleshooting steps.
  • Adds an example automation and Energy dashboard guidance.

You can also share your feedback on Copilot code review. Take the survey.

@c0ffeeca7
Copy link
Copy Markdown
Contributor

c0ffeeca7 commented Mar 10, 2026

Thank you for contributing, @smartcircuits 💪

  1. As this PR seems to be related to a code PR, please rebase and point this PR against the next branch.
  2. Please restore the original PR templatae
  3. In the PR template, add the link to the related brands PR.

If you do not want to rebase, another method to resolve this is to do the following:

  1. Close this PR.
  2. Switch to the next branch, and pull the latest changes from next.
  3. Create your branch from there, add your changes, and push them to GH against the next branch.
  4. Restore the original PR template.
  5. In the PR template, add the link to the related brands PR.

@c0ffeeca7
Copy link
Copy Markdown
Contributor

I'm drafting this PR, as changes are needed.

Please undraft it once the changes have been implemented and the PR is ready for review again.

@c0ffeeca7 c0ffeeca7 marked this pull request as draft March 10, 2026 07:26
@smartcircuits smartcircuits force-pushed the add-wattwaechter-docs branch from 6896995 to 9ef20d8 Compare March 10, 2026 07:56
@smartcircuits smartcircuits changed the base branch from current to next March 10, 2026 07:56
@home-assistant home-assistant bot removed needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch current This PR goes into the current branch labels Mar 10, 2026
@home-assistant home-assistant bot added the next This PR goes into the next branch label Mar 10, 2026
@smartcircuits smartcircuits marked this pull request as ready for review March 10, 2026 07:56
@c0ffeeca7 c0ffeeca7 added the new-integration This PR adds documentation for a new Home Assistant integration label Mar 10, 2026
@smartcircuits smartcircuits force-pushed the add-wattwaechter-docs branch from f1d2109 to f1a3a6d Compare March 10, 2026 08:05
@smartcircuits
Copy link
Copy Markdown
Author

Thanks for the review! Here's what I've done:

  1. Rebased onto next branch and updated the PR target.
  2. Restored the PR template with all required fields.
  3. Brand assets are included in the integration directory in the core PR (no separate brands PR needed since 2026.03).
  4. Fixed ha_release to 2026.4.
  5. Applied Copilot suggestions (table → list, "e.g." → "for example", YAML line length, system info wording).

The Netlify deploy preview fails — I believe this is because this is my first contribution and Netlify doesn't build previews for untrusted forks. The Lint Markdown and Lint Text checks both pass.

Core PR: home-assistant/core#165238

@smartcircuits
Copy link
Copy Markdown
Author

Thanks for the fix! I didn't realize mDNS/zeroconf weren't in the glossary — that explains the Netlify build failures. All checks are green now.

@smartcircuits
Copy link
Copy Markdown
Author

Hi @c0ffeeca7, just a friendly ping — I've addressed all the requested changes (rebased to next, restored PR template, fixed the glossary term). Is there anything else needed from my side?

Copy link
Copy Markdown
Contributor

@c0ffeeca7 c0ffeeca7 left a comment

Choose a reason for hiding this comment

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

style tweaks

@home-assistant home-assistant bot marked this pull request as draft April 9, 2026 09:58
@home-assistant
Copy link
Copy Markdown

home-assistant bot commented Apr 9, 2026

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

@smartcircuits smartcircuits marked this pull request as ready for review April 12, 2026 15:00
@home-assistant home-assistant bot requested a review from c0ffeeca7 April 12, 2026 15:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

has-parent This PR has a parent PR in another repo in-progress This PR/Issue is currently being worked on new-integration This PR adds documentation for a new Home Assistant integration next This PR goes into the next branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants