Hi I am new so please go easy on me. I am very angry because I have spent hours searching everywhere but canāt find an answer. I have many years of IT experience and it shouldnāt be this hard. Whatās wrong with the developers?
How do I <insert commonly asked question here>?
BTW, this isnāt a rant.
Thx
@aceindy
I can empathize with how you feel but I donāt know if thereās a simple solution. My impression is that some users learn about Home Assistant exclusively from what they see in the UI, not what they can read in the official documentation (let alone the community forum).
For example, I think the Numeric State Triggerās behavior is properly explained, in the official documentation and in the UI, yet itās a regularly reported problem due to a commonly held misunderstanding of its operation.
Another common misconception is that an automation waits for a condition to become true. How one arrives at that conclusion puzzles me because I canāt find anything in the documentation that even hints that it works like that.
Thatās why I sometimes ask the user what led them to their conclusion about how something works. Sometimes itās simply due to making assumptions and not the fault of documentation or examples (which they never tried to referenced). Not sure how to fix that.
I also donāt know āhow to fix itāā¦i guess it is un-solvable (as the picture shows).
But i do know that new users come in waves, and as they evolve, they end up at the same point where the experienced are now, They just stop responding (at least a lot less, as it becomes a never ending story). At least that goes for me, as i grow tired of itā¦.what i often do is post a link to a previous post which has a solution, and leave it at thatā¦
To me, i looks like all questions have been asked and answered, just need to searchā¦
And that brings me on another topic, hardly anyone knows how to search
The search is not always easy. I hear your frustration here and get it. But when Iām searching, that it hits hundreds of topics, that you click and it doesnāt land on that particular message you were looking for, some give up (Iām trying my best to not be one of them) and create their topic, adding to the hundreds of results.
But worst (in my opinion) are the ones who are coming on a old and/or closed topic with a new question or disproving the post marked as solution.
the earliest sighting of ārtfmā was approx 1983ā¦ and itās still here today
at some level itās an unsolvable problem because of the nature of humans. docs have this tough balance between simplicity and depth. good docs is really hard. and āyou donāt know what you donāt knowā is a challenge for all of us.
homeassistant is getting easier and easier. itās amazing how far itās come. but configuring it itās still best suited for someone whoās technically apt. lots of non-technical folks attempt, and if weāre honest with ourselves, the natural technical level that is optimial is higher than a meaningful percentage of folks who are actually configuring home assistant right nowā¦
still, homeassistant will get betterā¦ i have faith!
Another common misconception is that an automation waits for a condition to become true. How one arrives at that conclusion puzzles me because I canāt find anything in the documentation that even hints that it works like that.
didnāt we already establish that people donāt read the documentation? so it matters not a whit if the documentation is clear about this or it isnāt. this is a matter of UI design. i believe calling it a āconditionā is not the best choice. it falls in the real of āitās clear enough to be understood, but not clear enough not to be misunderstoodāā¦ which is the tripping point of a lot of uiā¦ that it CAN be understood, but that it doesnāt prevent misunderstandingā¦ i believe in many peopleās minds when they think about their automation, they donāt think āi want to do this when this trigger happensā i think they think āi want to do this on these conditionsāā¦ so the human language leads them to think about conditions as the trigger.
in this case, for example, if it were called ārequirementsā, iād guess weād have less of this issueā¦ and in fact, if it were me, i would probably put it under a collapsable arrow so that itās hidden by default.
ui design leads the behaviors because, as we establish, no one rtfmās.
As always there rarely is one answer, it always is a combination of factors. And as said above, UX matters a lot. Some designs invite errors, some prevent them. But for automating, good UX is harder than most tasks.
Yes, some people are lazy and do not read the docs or do not search. But many do search and do read and still fail.
I too have problems finding things on the forum that I know are there. I guess mainly due to the fact that there are so many threads mentioning the same keywords.
And as for reading: many programmers are secure in formulating and reading, but most people are not. They read what they expect and do not notice that is not what the text actually says. They miss important keywords, such the significance of the word ācrossesā in a state trigger. People will think: but it has crossed it, and do not realize that it matters that the moment has passed long ago. Many think āwhenā and āifā in automations are synonymous. They do not realize āwhenā is a designation of time, and āifā is not.
Last but not least, this is harder to interpret explanations in another language. Also at times translations in native languages are not precise, losing some of the significant distinctions.
So I try to be patient, and not assume laziness. But is is, and remains, hard not to get irritated about it.
Grammatically the word points to a moment in time. I cannot see how there can be any confusion. Even for non-native English speakers, Iād consider this basic vocabulary. If I say the whether is sunny, it means right now. Thereās no waiting implied. If I say my condition is that Iām fit or healthy, it doesnāt imply a desire. Itās whatās true right now. Itās if, not when. Logically you wonāt say: turn on my light if the sun sets. You say when the sun sets. That said, I think there were changes made to the UI automation editor to use wording like āand ifā for conditions ā yet some people complained about that. Donāt quote me: I donāt use the UI.
I agree, but my gripe is the search box itself. If you search for two terms, the assumption is made that those words are consecutive, not that both needs to exist independently. Youāre better off searching the forum from Google, generally speaking. Maybe there are forum search tricks Iām unaware of.
The HA condition may be a little unusual in that its main function is to stop the automation if it is not true. Most people probably think in terms of continue if trueā¦
It has improved a bit, but yes. Also links to generic topics are swamped by links to integrations for particular products.
Still, lets be positive. When I put a link to the docs in a post I usually come back to find several people have followed it. Which is a good thing. Isnāt it?
and yet there is the confusionā¦ soā¦ i think empirical proof is on my side
thatās UI design for youā¦ āi donāt see how someone could misunderstandā is the trap of underestimating the nuances of good UI. if thereās a way to misunderstand ui, people will find it.
Iām not going to get into a contest of credentials. You can search me if you want.
At some point people have to learn too: home automation introduces concepts not usually seen elsewhere and it is technical by nature. Iām not against simplifying or clarifying, but there is a limit.
Maybe we need a collection of simpler stuff in Community Guides - or a new āCookbookā category. To go back to the OP, @tom_l has done a post on this which deals with the question in a few lines:
Natural language is not used the same way as programming languages are. No one takes everything literally. Most of the time that is a good thing, sometimes it is not.
When people ask you to pass the salt at dinner they will assume youāll give them the the salt shaker too, not just what is in it. Technically speaking, that was not what was asked. To most people that is clear without them even thinking about it. But it shows people will automatically make assumptions about what is said. Those assumptions are based on how people view the situation. Assumptions that can be wrong if people lack experience with that particular situation.
Home Assistant seems to be making efforts to enhance user-friendliness and accessibility, catering to individuals stepping out of their comfort zones. While itās unfortunate that not everyone possesses the same level of expertise as some of the users in this community, itās worth considering whether the repetitive nature of certain questions is due to user oversight or if it reflects shortcomings in the simplicity and accessibility of the documentation?
I acknowledge that the comment may sound somewhat provocative; Iām partially adopting a devilās advocate stance. Itās important to recognise that there is no definitive right or wrong in this situationājust differing perspectives.
Yes, I agree very much here. Although there are youtube videos, these do not always have the simplicity required for beginners.
Having mutiple clear examples, videos, and prebuilt automation examples.