WTH Why is it so hard to set up the MQTT add-on?

[OldSurferDude]

I have had similar concerns about documentatioon.
Here some of the responses I’ve gotten:

• Read the documentation
• at the bottom of every documentation page is a box for you to be able to change the page
• volunteers work hard on the documentation, give them a break

I quote:

@123

1. Improve reading skills.
2. Devote time for learning new concepts.
3. Don’t assume previous experience offers advantages.
4. Use search and/or hyperlinks to find related content.

Lastly, to keep in mind that hundreds of thousands of productive users have preceded you and they referenced the same documentation (actually, an older, less comprehensive version).

As you can see, there is no fault with the documentation. Carefully understand 3. What 123 is saying here is that HA uses its own conventions.

As in your case, and my experience, too, the documentation is frustrating because it is incomplete.

So put your suggesting in the feedback part of the of the Help us improve our documentation, hope that someone will read it and improve the page and then gird yourself for your next frustrating adventure into the documentation.

OSD