This is my second attempt at using OpenHab (I admit to still using Home Assistant for some things).
Things have improved greatly with the advent of ‘Eclipse SmartHome Designer’ but lots of things haven’t and some issues are worse than they were before.
Documentation remains the single biggest issue. It is now much worse with the advent of OpenHab2 because now it is generally impossible to discern the status of advice in the Forums. In addition, no one has taken on board the problem of examples (with a few exceptions).
To illustrate the issue I’m going to highlight problems I have. Please don’t offer fixes in this thread as I want this thread to discuss how to resolve the documentation problem and to discover how many other Users are facing my perceived problems. Please don’t take offence if I choose to highlight an issue that isn’t a problem or for which there is a simple answer, ‘cos for me I didn’t find the answer and it wasn’t simple.
So here we go.
I want to use MQTT as a way of communicating information between OpenHAB and external systems for which there isn’t a binding or because MQTT allows for data sharing. MQTT seems to be in a funny limbo. It is described as a ‘Legacy’ binding (and I read that can mean it doesn’t show up in ‘Paper UI’. BUT IT DOES. I can select an Addon and select install. Paper UI then never updates but if I restart, lo and behold MQTT is there. Here is where it gets difficult. I can get some MQTT data set up as Items and I eventually got it to display (Openenergy stuff). But try as I might I can’t get a simple switch to show anything much less operate. (I know MQTT is ok ‘cos Home Assistant worked right away (after I’d struggled with that damn YAML nonsense) There isn’t a single example that shows an item definition together with a sitemap entry and resulting screenshots. And that is typical of almost every binding definition. Yes they describe some of the parameters (most have an example but only one) and most don’t explain all the options.
Sometime the Community has stepped up BUT now we face the big issue. What is relevant. Do all community examples work everywhere (I think not). Which work in OpenHab2? Where is THE definitive BEST way to accomplish simple tasks. There seems to be a myriad of alternatives. That must be a support nightmare.
Home Assistant seems to bring out updates once a week. It is two/three months since OpenHab2 arrived and no update, no bug list, no fixes, no documentation. While I don’t want weekly releases I would like a bug list, next release date and documentation to match the release. Oh and that’s a gripe too. Wiki is mentioned in respect of the documentation. It’s not a wiki I recognise. No History of changes, no authors, no obvious means of updating, no discussion page.
I could go on but won’t. I hope others have their gripes to be aired and I’d like discussion on solutions. For example why can’t the Community threads be split into OpenHab Legacy and OpenHab2. It would save a lot of dead end searching and time wasting!