-
-
Notifications
You must be signed in to change notification settings - Fork 7.7k
Update the MQTT fan documentation #1345
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
Conversation
@wingrunr21, thanks for your PR! By analyzing the history of the files in this pull request, we identified @fabaff to be a potential reviewer. |
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.
Good addition but one change that would need to be made.
|
||
Optimistic mode can be forced, even if state topic is available. Try to enable it, if experiencing incorrect fan operation. | ||
Optimistic mode can be forced even if a `state_topic` is available. Try to enable it if you are experiencing incorrect fan operation. | ||
|
||
To enable MQTT fans in your installation, add the following to your `configuration.yaml` file: | ||
|
||
```yaml | ||
# Example configuration.yml entry | ||
fan: |
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.
This is a great addition but the example code should always try to be minimized.
Feel free to have a fully fleshed out example also but avoid having the Optional variables in the minimized one.
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.
So happy to make the change but the way the original author defined the component would mean the minimal version would ONLY be the command topic. Would you be ok with some kind of happy medium?
With home-assistant/core#4134 was the documentation updated without taking that PR into account. Duplicated work. I will fix my mess. |
This is a documentation update for the MQTT Fan component. When the original component was merged (via home-assistant/core#3095) incomplete/incorrect documentation was added at the same time. This brings the docs inline with the component.