The Road Ahead - Reintegrating ESH

Hi Yves,

I just checked the contribution guideline of openHab (https://www.openhab.org/docs/developer/contributing/governance.html)
This seems to be pretty much exactly the same rules as at Eclipse. There is an CLA defined, there is an election process for “maintainer”. even the three core principles are the same. I do not see how this is “giving everyone write access”.
At the end, I believe that the Eclipse ecosystem would benefit from hosting such a great community such as openHab and vice versa I believe that openHab could make use of the benefits that the Eclipse ecosystem provides, especially because the core principles and rules seem to be exactly the same.
More important, and that is why I raise these questions here: If there are specific things / rules / guidelines in the Eclipse ecosystem that motivate a community such as openHab to stay outsite and basically fork, it would be interesting for the Eclipse community to know about these and ideally fix them. That is why I am interested in the details

Thanks!

I don’t think it comes down to core principles and rules, those are indeed similar. But, for me, it boils down to brand and identity. openHAB (yes that’s how you write it :wink:) and ESH are 2 different communities. With openHAB it feels to be part of something. With ESH it feels much more like some ‘corporate’ organisation. As an individual I have a harder time identifying with such an organisation. Actually if you say eclipse I think IBM. This maybe totally unfair and doesn’t have any rational base, but that’s my association. (I’m not saying that is bad, it just feels more like work and not fun). What doesn’t help is if I go to the ESH forum it looks dated. It’s very hard to read, and doesn’t really invite to ask questions. I even wasn’t aware until recently there is also a mailing list. But it’s 2019 and who is using a mailing list today? I haven’t’ been involved very long with either communities, but I have contributed both to ESH and openHAB. But ESH never felt like a community, more like work. (Probably also because it never promoted an end product that appeals the end users). So to succeed in an environment that targets and would appeal to individual developers it should at least display a much more modern identity.

3 Likes

Again, I wasn’t part of the decision and don’t know all that went into it. But I think at least part of the answer to your question about how OH can evolve more freely are in Kai’s OP.

Emphases is mine.

I don’t necessarily think there is anything about the over all governance of Eclipse that is a problem. The problem was that openHAB was split in half. Speaking from just a user who supports others on the forum, just figuring out which repo to direct others to to file an issue was a chore. Some bindings were over at ESH, others over here in the OH repos.

hilbrand’s comments are not the only one’s I’ve heard regarding the forum and email list approach on the ESH project. The lack of a vibrant developer community on ESH, which is partly driven by that unnatural boundary Kai mentions is also hindering OH’s forward progress and flexibility.

Ultimately I think the major drivers had to do with what I mentioned above. openHAB is better known brand and since the bulk of the existing work already takes place under openHAB it was less work to move ESH to openHAB than to move openHAB to ESH. The openHAB Foundation is also a major concern and it’s not clear how that would work with ESH.

The following is going to be just my opinion based on my interpretation and interpolation from comments I’ve seen from developers. The core of OH was initially moved to ESH because of the promise that we could encourage commercial use and, more importantly, contributions. And at first that seemed to work out. PaperUI was initially developed and contributed in such a way.

However, over time, that approach hasn’t worked out. Many of the companies using ESH are not contributing back. Others who have contributed have stopped. And in some cases we are left with code to support that no one in the OH community can maintain. For example, PaperUI is apparently built using a JavaScript framework that none of the OH maintainers knows or is willing to learn. Why is PaperUI so far behind and frankly sucks in so many ways without forward progress? Because the company that initially contributed it isn’t maintaining it any more and we are stuck with this thing we can’t maintain and improve ourselves.

As a result, the extra work created by the “unnatural” barriors between the two projects is no longer coming with any benefits to openHAB. And because of the branding and the foundation, it makes more sense to move everything over to openHAB than it does to move everything over to ESH.

I fully get that the boundaries were creating overheads. I also understand that openHAB is the better brand. I also agree that ESH obviously did not have any significant community, as we have seen the drop of one company killed the project. Not to mention: I also agree the default forum at ESH is ugly.
What i essentially wonder about is whether it would be beneficial for the openHAB community to join the Eclipse community (e.g. as a working group), pretty much like the IoT and the JavaEE communities did over the last years.

That’s a question well above my pay grade. I don’t have any major opinion either way. I’d have a lot of questions about exactly what that looks like, but ultimately I have no power. As I’m fond of saying, you don’t have to convince me. :wink:

I do recommend starting a new thread for this though. Tag the key players and make your case. What benefits would come to the OH community? What would it cost (in effort obviously) the OH community?

1 Like

This seems to be pretty much exactly the same rules as at Eclipse. There is an CLA defined, there is an election process for “maintainer”. even the three core principles are the same. I do not see how this is “giving everyone write access”.

I was talking in general. I still consider it possible or at least easier to move to “giving everyone write access” on the openHAB github then on the eclipse project.

What i essentially wonder about is whether it would be beneficial for the openHAB community to join the Eclipse community (e.g. as a working group), pretty much like the IoT and the JavaEE communities did over the last years.

I was not involved, yet what I read is we have a vibrant openHAB community and a eclipse community that is not involved in openHAB, why would the vibrant community move to the non vibrant site, risking everything.

from my distance side, it looks like openHAB did indeed try to join the eclipse community and it did not work out and now they are leaving.

As the Executive Director of two technical trade associations and as a contributor to the OH documentation (until I ran out of bandwidth :-(, I would share a few observations.

  • A key difference between OH and ESH from a contributor perspective was people. @rlkoshak, @Kai and a number of others in the documentation team immediately made me feel at home.
  • Response was quick - really quick! You felt like people were here and engaged. Try to make your first documentation contribution, and you got instant, positive feedback (i.e. nice try - here is our process, we love your contribution, could you please do it this way. Prospective contributor thinks, “hum - that’s not too bad. Sure I’ll do that”).
    Contribute to ESH and after a while you get back a contributor agreement to sign. To try to help with some grammar errors in documentation. As someone said, it felt like a corporation. OH feels like a community.
  • Low barrier to contribution. Figure out a simple process, clone a repo, create a PR, sign off your work, and sometimes in an hour, the review is complete and when you look, your work is already published to the world. Nice. Nothing like positive feedback to make you feel like contributing again (hey! I am making a difference!). Contribute to ESH and do you get the same very fast positive feedback? Meh - not so much. Your contribution may hang around for so long that when you finally do get a response, you have to go look to see what it was you contributed.
  • Quick support for issues. Everyone knows that @rlkoshak is a star, but there are many others who troll the community looking for questions they can answer. And believe me - when you are new to a project, and you see a question you can answer, your fingers fly across the keyboard the first time you do it, hoping that some OH Ninja doesn’t beat you to post a response. You can contribute, and that builds a sense of community that sticks.
  • Taking but not giving back in a ‘corporate’ open source environment - yeah, that’s a thing. But not unique to ESH. In the community-driven open source world people contribute because they believe in the project, they want to see their contributions out there making a difference, and because they likely consume the work of the project themselves. In the corporate world, entities contribute to a project because it serves what I call their “enlightened self interest”. I run into this all the time. My trade associations have companies that compete very strongly against each other. They are in the trade association because they have mutual pain, and they think by contributing they can lessen their own pain, and that contributing does not advance their competitor too much. Many companies will only be in ‘monitor mode’ listening in and taking from the group but not contributing. That is just the way it is. And no corporation is going to finance an open source project unless they have figured out a commercial angle for it. Take the OpenVAS security vulnerability scanner. It was the core of a commercial product. Greenbone, the company, decided things were not working out, left some stuff public (now the scanner is available through a maintained package in the Kali Linux security distro), and is selling vulnerability scanning appliances and services. Frequently corporate open source projects take a tortured path into oblivion. Let’s set OH up for success in a true open source community, not tie it to a corporate “open source” environment where it dies a lingering death.

Having been a frequent contributor to the OH documentation, I would ask (beg?) the AC to keep it very simple to contribute, keep the process very lightweight, worry less about the legal parts to avoid feeling corporate, and make the whole thing feel like a comfortable and familiar home for anyone who is willing to give up some of their nights and weekends to contribute.

Low friction to contribute. Community feeling. Fast and positive feedback. A familiar and lightweight process. Modern environment and best practices in tooling. Keep it simple.

My two cents.

31 Likes

Hi all,

can you clarify something about licensing?
Having eclipse smarthome under the eclipse foundation was meaning that all the component included were of the right license.

This will be the case for openhab-core?
There will be a simple way to exclude all the non EPL-2 libraries for example?
There’s a plan to move all the license troubling components to for example openhab2-addons?

from a commercial point of view will be very difficult to integrate openhab-core if it still contains dependencies from for example GPL-3 libraries

Thanks for your work
Nick

openhab-core is Eclipse, Apache, MIT license only, that has not changed. Contributed code must be Eclipse License v2.

openhab2-addons allow more open source licenses, but generally also only the listed ones. The NOTICE file of each bundle tells you the story.

I don’t think there are GPL libs in OH core or official addons. Peace of mind. :slight_smile:

When using third party non-official addons in your solution, check their license terms.

If you don’t have intentions to sell your solution, you can combine any kind of code.