UX logic on first startup

[TFTDgh]

This is my first try to write something like this. I'm looking forward to feedback on how to make this more helpful in the future. And I hope its a good way, to do it here.

For a new setup of openHAB the default behavior of the Android App seems confusing. This feature request is about changing it.

Motivation: As a new user the install process and the fist steps directly guided me to the point that I configured my first page as a Layout. This was the case, because in the admin interface ( http://openhabian:8080) under Pages I already found an item called Overview of the Layout type.
So because it was there, I started to configure it, to learn how things work.

Next I started the Android App and got greeted with an Error message. (Empty sitemap list). This is a very confusing experience for a beginner. Especially because it is not really obvious how I need to proceed. Google erroneously told me, there is no graphical editor interface for sitemaps. The Sitemap docs also directly suggest to start with the Overview page and tell me, I can only edit files and need to be able to write code.
I'm a beginner and want to get going, learning the coding language is not what I want to do right now. I want to have some positive experiences with getting results and stay motivated. Therefore this is not an option for me at this point.

Possible solution

• One Startup of the app provide a welcome dialog telling me, that it is normal to see the error I'm seeing.
• Tell me that I can configure a Sitemap under Pages by adding create sitemap
  • Suggest as in the linked doc, to start with the overview page and tell me that in the settings it is possible to default to Main UI on startup of the app
• Point me to the above linked sitemap docs
• Tell me that clicking on Main UI will bring me to the default Overview Layout if configured

Additional context

• By changing the default screen the startup of the app takes longer now and you can see that it starts the normal screen and then switches. That is a little bit annoying for the eyes
• The _create sitemap- has been found by me, just by random trying out the options I can configure. So I was little bit lucky to understand why the error and how to make it go away
• I manged to configure the sitemap in such a way, that I could crash the app by interacting with it, I did not manage that for anything else I tried. I'm also not sure, which advantage the sitemap has to all the other options. Could anyone explain that to me or point me to docs which talks about that? Also the logic that I have an About on app startup and I have an About reachable from the Main UI_ (I have a rough feeling what the logic is, but I would like to have it confirmed, so think of some better UX ideas)

Based on my newbie point of view

• Try to make the default in such a way, that the error doesn't show and that you are not made aware of the existence of sitemaps and distracted with it (and that you are not pointed to something which seems to easily crash the app when configured wrong)

[mueller-ma]

In the past Sitemaps have been the primary UI for openHAB and thus the app defaults to Sitemaps. Since openHAB 3 Main UI is pushed more than Sitemaps, but the app still defaults to Sitemaps.
A refactor on the app is required to a have more than one UI as "first class UI" which would fix some other issues (e.g. fallback to Sitemaps when connection is lost). Than the intro could be refactored to allow the selection of the preferred UI (or auto-select Main UI if there's no Sitemap).