That’s not correct. Please only edit the wiki when you are absolutely certain of the correctness of your edits (this strict rule applies to everyone). Please revert all differences from previous that have been based on any misunderstandings. The wiki is not the place to evolve an understanding of how openHAB works, because that degrades the product and propagates these misunderstandings to others.
The openHAB 1.x core is stable and working as intended in this area for years. The REST API has been delivering expected output to stable clients also for years. The functioning of these two interdependent areas is working as designed. While you may have a different opinion as to what the architecture ought to be, that is very different from the designation “bug.”
I’m sorry if my comment read as directed at you, it was meant to be generically applicable to everyone.
I am repeating myself because I am concerned that a very important wiki page is being changed by well meaning people who are only recently understanding the core of the system, and it worries me greatly that inaccuracies introduced into the documentation will propagate to other new users and degrade the project, which of course none of us wants!
The main reason that openHAB is so hard to pick up is the poor “official” documentation.
The poor documentation is partly the result of people feeling too scared to update the wiki because they might get it wrong. But we should embrace the concept of a wiki and not be afraid. There are countless posts in threads that say things along the lines of “can someone update the wiki”.
Of course no one does, and why should they
If there is official documentation then cool, don’t let anyone edit it. But as that is not going to happen any time soon, isn’t the only option to rely and use the concept of a “wiki” where if there are mistakes made by one person, then another can hopefully correct them.
(smiley face added to make sure the above is not read in anything other than the light hearted casual “no such thing as a stupid question” tone)
I am still confused about the differences between “Accepted Data Types” and “Accepted Command Types”.
In the case of a Dimmer, you can ‘sendCommand’ of OnOff, Percent and INCREASE/DECREASE. All will affect the actual light. But the only value that is saved in the state is the Percentage. That is why I made the edit to the table initially.
Sam and Hagen, I’m sorry if I sounded harsh. You are absolutely correct that the documentation is in need of improvement, and as it’s in the form of a wiki, it’s open to all to evolve it. My only point is that, as long as confusion remains about various aspects of openHAB, the confusion should be fully resolved before editing the wiki pages, lest that confusion enter the wiki pages and spread to others. While we should not be afraid to contribute, we should in fact be afraid to spread confusion to others.
I suppose any harshness in my comments comes from a frustration with the state of the documentation, and in no way with the people willing to step up to improve it. The last thing I want to do is discourage people willing to contribute.
The project owners are well aware of the situation with the documentation, and want to recruit people willing and able to improve it. That being said, openHAB 1.x is very near its end of life, so the real opportunity is to have a fresh plan to create solid documentation for openHAB 2. For openHAB 1.8, adding new wiki pages that offer guides and tutorials would be generally safer than altering core information in the basic pages, and after all doubts and confusion are eliminated (probably via this forum).
Thank you, Sam and Hagen, for your even tone and positive attitude towards contributing. Many will benefit from your efforts.