Rules: Replace placeholder with ESH text

[davidgraeff]

This is a first step in improving the NG Rules page.
In a follow up PR this is split up into a technical part and a user part and https://community.openhab.org/t/experimental-next-gen-rules-engine-documentation-2-of-installation/55955 need to be integrated of course.

Signed-off-by: davidgraeff [email protected]

[netlify]

Thanks for your pull request to the openHAB documentation! The result can be previewed at the URL below (this comment and the preview will be updated if you add more commits).

Built with commit baf4384

https://deploy-preview-893--openhab-docs-preview.netlify.com

[Confectrician]

Note for myself:

First of all we should check the sidebar config.
The page is located under the configuration folder but in the sidebar it is displayed under interfaces and ecosystem.

[5iver]

TMK, we haven't been given the go ahead to remove 'experimental'. IIRC, this is to be removed in OH3, and at this point, we can't be sure that will be the next release. There are also a lot of changes yet to come to the NGRE, so IMO it is probably best to keep that label to set expectations in functionality and the potential for breaking changes.

[Confectrician]

Hey @davidgraeff ,

Sorry for the delay.
I had some time for a first look.
Because of the amount i think i will have to look at the contribution again.

Here are my first comments.
Most of them are markdown related.

BR
Jerome

[davidgraeff]

@openhab-5iver I have added the "Experimental" badge, which looks more professional IMO. But can revert that of course.

Also: If we are fading out DSL Rules, so recommending Jython/Javascript, this module will always be installed. Maybe we should replace "Experimental" with "Not-yet-for-end-users" or so.

[Confectrician]

Hey @openhab-5iver ,

We could also edit the sidebar and add an (Experimental).
Anyways David has left the disclaimer/note at the beginning of the article so we should be safe for now.

This PR will be a huge improvement to the ngre documentation and a good base for imrpoving when we get changes or new functionality.

BR
Jerome

[5iver]

I have added the "Experimental" badge, which looks more professional IMO. But can revert that of course.

Oh, sorry. I missed that! It does look better and more professional.

Also: If we are fading out DSL Rules, so recommending Jython/Javascript, this module will always be installed. Maybe we should replace "Experimental" with "Not-yet-for-end-users" or so.

Actually, I've wondered whether all rule engines shouldn't be made optional. IMO, it can be labelled with anything that keeps people from thinking it's mainstream, or the only rule engine, or ready for for use. But we've been using 'experimental', so probably shouldn't change it.

We could also edit the sidebar and add an (Experimental).

Adding to the sidebar would be another helpful alert for people too!

[davidgraeff]

This is the technical description of the rules system however. It need to be split into a "technical concepts + details" page and a second page that is more user-centric. I will do that in a follow up PR after you guys sorted where to put this page here in the sidebar navigation. I suggest the development section as it is very technical.

[Confectrician]

Thanks @davidgraeff,

Everything adressed and already a huge improvement.