Since there is no developer that can work with the Paper UI it is recommended only for administering openHAB. The Basic UI or HABPanel are recommended for daily operational use.
Since the mobile apps are generally based off the Basic UI sitemaps, most people use the Basic UI.
We are trying to help not debate as this info is part of the documentations. Create a sitemap and see what happens. If not then maybe OH 2.4 is better for your purpose.
When OH2 started there were some companies interested in using OH in their products. Our developers started Eclipse Smart Home as the OH2 technology base, hoping to attract company participation, OH2 became the free implementation of ESH with some additions.
One company donated the developer resources to develop the Paper UI. It was not completed before the developer abandoned it and they used a technology not familiar with our other developers. OH developers began looking toward other UI options for OH3 and recommended the Paper UI for administration use only.
After several years (2+ I believe) of not getting any company participation, it was decided in January 2019, after 2.5M1 had been released, to merge ESH into OH. 2.5M2 arrived 8 months after M1 with that merge and a completely redesigned build system. That is why 2.5 Stable was no released in the normal 6 month cycle.
Although OH3 has been declared as the next major release, there is also work on a patch release 2.5.1.
That looks like (another) case of the documentation not being updated. Thank you for showing your source of confusion. I thought you might have been a real early OH2 user.
So-so I’d say.
I have a lot of experience in the Linux, networking and security sector.
I also use OH2 for something over 2 years now in my spare time.
So I’m familiar with the concepts but the Basic-UI and sitemap thing never got my attention since OH2 did what it should by PaperUI.
A few months ago I decided to upgrade to the development branch of OH2.5 and it bothered me, that PaperUI was “hiding” it’s configuration on the CLI from me.
So I tried to move my config from PaperUI to config-files, which got stuck by the lack of time.
This needs to be done next. Including creating a sitemap.
Sitemaps are not too difficult. If you are moving to text files, I recommend not making text files for Things unless required by the binding. It is usually less error-prone to have them auto generated.