openhab / website

This repository contains the final artifacts from which the project website is served.
https://www.openhab.org/
21 stars 47 forks source link

openHAB 4 blog post #412

Closed florian-h05 closed 1 year ago

florian-h05 commented 1 year ago

Let’s create the openHAB 4 release blog post together!

The preview can be viewed here: https://deploy-preview-412--openhab.netlify.app/blog/2023-07-23-openhab-4-0-release.html

jlaur commented 1 year ago

@lolodomo, would you like to contribute a section for the new sitemap improvements, like extended icon support and input elements?

@florian-h05, JavaScript Scripting also has some cool new features, for example Quantity. Perhaps you would like to highlight a few?

I guess the UoM improvements will be mentioned in the release notes, so that there is no need to mention here also, or? See https://github.com/openhab/openhab-distro/releases/tag/4.0.0.M3. Although combined with JS Quantity, new units and the sitemap input element it's kind of a theme, and more coherent than ever.

kaikreuzer commented 1 year ago

I guess the UoM improvements will be mentioned in the release notes

Yes, see https://github.com/openhab/openhab-distro/wiki/openHAB-4.0-Release-Notes----DRAFT. Maybe @J-N-K wants to write a small prosa section in the blog about it and reference the release notes for detail. I agree that there is a kind of "theme" on the support of UoM changes throughout the release. But I'd leave this to him, how important he considers it.

lolodomo commented 1 year ago

@lolodomo, would you like to contribute a section for the new sitemap improvements, like extended icon support and input elements?

Yes, I will contribute that.

florian-h05 commented 1 year ago

@jlaur

@florian-h05, JavaScript Scripting also has some cool new features, for example Quantity. Perhaps you would like to highlight a few?

Yeah, I will write something about it. I’ll also address your review later.

@openhab/jruby-maintainers Do you want to write something about jRuby in the release blog post? I don’t follow the development there …

@GiviMAD Anything new on the voide side?

jlaur commented 1 year ago

@florian-h05 - I started writing a small bit about binding highlights. I might have missed something. Please use/throw away/modify/whatever you like. You might want to delete the Energi Data Service section since it's mostly for Denmark, and I'm incompetent to mention it as I wrote it (same with VAT transformation). 🙂

Add-ons

(Introduction/numbers)

18 new bindings are included, supporting new devices and services. The PLEX binding, which has been missing since version 2.x, is back! The Android TV binding enables interaction with Google TV and Nvidia ShieldTV. The Ecovacs binding integrates a variety of vacuum cleaning/mopping robots. The Energi Data Service binding provides electricity prices primarily for Scandinavia, and with the VAT transformation, VAT is included according to your configured country. The ChatGPT binding allows AI interactions where only your imagination sets limits to the usage. How about announcing the weather forecast in a personalized way on your preferred speaker?

Some existing bindings also received massive overhauls. The Philips Hue binding has been rewritten to support APIv2, offering real-time updates from lights, switches and sensors. Similarly, the Hunter Douglas PowerView binding now supports the new PowerView Gen 3 system with blazingly fast updates. The deCONZ binding has been improved with new features and many bugfixes and stability improvements. The Freebox binding is replaced by a new binding rewritten from scratch.

J-N-K commented 1 year ago

I believe KNX is widely used and has large improvements including full UoM support.

jlaur commented 1 year ago

I believe KNX is widely used and has large improvements including full UoM support.

Yes! I knew I had forgotten something significant! 😄 I'm not sure how to shortly describe all that since it's pretty technical and I have not been involved in those PR's. Anyone?

GiviMAD commented 1 year ago

Hello, I didn't made too much contributions for this release.

I introduced the register dialog functionality to the voice manager, which allows to create persistent descriptions of the desired services and options for the dialog processor but let the voice manager in charge of create/recreate that dialog proccesor when all the required services are available. I think it can simplify the integration of the dialog configuration into bindings that register audio sink and sources like the pulseaudio one, but for now it's only usable through the cli.

Also I made minor improvements to the openhab-cli voice commands:

I don't know if it's worth to reflect these changes in the release blog, I was writing a little post for the forum about how to configure a speaker using pulseaudio and rustpotter as keyword spotter, to get some feedback on the library and the current dialog support.

lolodomo commented 1 year ago

@florian-h05 : I just submitted a PR to your repo branch to include the icon stuff. Merge it and then please adjust it in case the English is not good.

I will submit later another PR for sitemap UI (new input field).

florian-h05 commented 1 year ago

@jlaur:

I started writing a small bit about binding highlights. I might have missed something. Please use/throw away/modify/whatever you like. You might want to delete the Energi Data Service section since it's mostly for Denmark, and I'm incompetent to mention it as I wrote it (same with VAT transformation). 🙂

Thanks, I‘ll add that later. IMO we can keep Energi Data Service, since it‘s a new binding and it‘s only a sentence.

@J-N-K Do you want to write something about KNX? Either a section or a few words to add what Jacob already wrote. And probably also something about the core changes.

@GiviMAD:

I don't know if it's worth to reflect these changes in the release blog, I was writing a little post for the forum about how to configure a speaker using pulseaudio and rustpotter as keyword spotter, to get some feedback on the library and the current dialog support.

Thanks for the info, I would leave those changes out of the blog post and focus on the big things.

J-N-K commented 1 year ago

I think I already wrote something about UoM. I can check if there are other notable changes in core that are not already covered (like persistence/transformation registry or script transformation)

lolodomo commented 1 year ago

@florian-h05 : I submitted a new PR for "New input field for sitemap UIs".

lolodomo commented 1 year ago

I am not sure it's worth communicating in 4.0 on the capability for the user to extend the semantic tags since my PR that would have made things super easy was finally not merged. Probably rather something to keep for 4.1 release notes.

I will rather open a topic on the community forum for very early adopters, providing the necessary bundle and explaining the expected YAML file syntax.

lolodomo commented 1 year ago

IMHO, is is essential to have a section for the new UoM stuff.

Looking at all merged core PRs, maybe these themes not discussed in details in the other part of the blog post could be of interest to be mentioned (as not too much technical) at least with a small sentence ?

ghys commented 1 year ago

Folks, when you link to a docs page or an addon, please remember to use server-relative URLs beginning with a slash - like /docs/... or /addons/..., not the full URL (https://openhab.org/...) it will usually speed up the page transition, make sure you don't have an "external link" icon beside the link, and also it will refer to the same website as we have multiple instances of them running for different versions.

florian-h05 commented 1 year ago

@lolodomo:

I am not sure it's worth communicating in 4.0 on the capability for the user to extend the semantic tags since my PR that would have made things super easy was finally not merged. Probably rather something to keep for 4.1 release notes.

Yeah, let's put this in the 4.1 blog once everything is finished.

IMHO, is is essential to have a section for the new UoM stuff.

Looking at all merged core PRs, maybe these themes not discussed in details in the other part of the blog post could be of interest to be mentioned (as not too much technical) at least with a small sentence ?

Agreed, do you want to write something or take something from the release notes?

florian-h05 commented 1 year ago

@kaikreuzer When has the blog post to be finished? I will add the missing images and write the activity section this afternoon.

And we still need an image …

kaikreuzer commented 1 year ago

@florian-h05 IT is enough to finish it by 8pm tonight. I have already the stats on LoC and no of PRs, but it is probably easy for you to extract them as well. I will be only back at my keyboard tonight, so if you like to write the activity section, it would be appreciated.

Wrt an image, I have generated one - if you like it, we could use it:

disk ai_beach_smart_house_award_winning_photography_nature_extr_518c89b2-3460-434a-aaa3-1c7a88474c65-1

florian-h05 commented 1 year ago

@wborn:

Can you also add a few more spaces?

Where exactly? Can you please open a PR to my branch?

@kaikreuzer:

I will see if I can write the activity section :+1:

Wrt an image, I have generated one - if you like it, we could use it:

Looks really good, thanks. Out of interest: How did you generate it? Dall E 2?

kaikreuzer commented 1 year ago

Looks really good, thanks. Out of interest: How did you generate it? Dall E 2?

This is done by Midjourney, my favorite GenAI. 😎

florian-h05 commented 1 year ago

@kaikreuzer Do you know any trick how to find out the top contributors (preferably per repo) for the 4.0 release? I'd like to thank you them as in https://www.openhab.org/blog/2022-12-19-openhab-3-4-release.html#activity.

EDIT: Just found it in the repository insights.

florian-h05 commented 1 year ago

@kaikreuzer I added the activity section, please have a look. For add-ons and WebUI, I have to wait for tag creation to get the LoC.

kaikreuzer commented 1 year ago

@florian-h05 Looks great, thanks! One remark: I wouldn't take the number of added lines, but rather use added-minus-removed, since often it is just moving code around and it is not really valid to claim that all those added lines are new. With this, my yesterday's count came to: Core: 13171 LoC Add-ons: 117453 LoC Web UI: 10440 LoC

florian-h05 commented 1 year ago

@kaikreuzer:

One remark: I wouldn't take the number of added lines, but rather use added-minus-removed, since often it is just moving code around and it is not really valid to claim that all those added lines are new.

Okay, thanks. Should I use your counts from yesterday or should we re-count since we have a few PRs merged today?

I just pushed a commit with several wording improvements after re-reading the whole post.

kaikreuzer commented 1 year ago

Should I use your counts from yesterday or should we re-count since we have a few PRs merged today?

I think it is ok if you mine from yesterday. A few lines more or less do not matter much.

florian-h05 commented 1 year ago

@kaikreuzer Please let me know when you are finished so I can contribute all your suggestions at once.

florian-h05 commented 1 year ago

@kaikreuzer Great, thanks.

From my side we are finished and this can be merged once the build completed.

florian-h05 commented 1 year ago

@jlaur I changed the picture and addressed your review for the sitemap code.

ccutrer commented 1 year ago

Still the 23rd for me :). With several hours to spare.