Resources

I’m going to close this posting as premature. The wonder work that David has done on the PaperUI-NG is awesome and really goes a long way to show us what is possible. But PaperUI-NG is just one developer’s proposal right now. We need to wait for the establishment of the Architectural Council to review and discuss and decide what direction OH wants to go. Therefore creating documentation for it is premature as what eventually replaced PaperUI-NG may be significantly different. It may also be exactly as presented. We don’t know.

I’m taking this post back from being a wiki to a regular post.

I recommend further discussion and work towards a Beginner’s Tutorial move to @bartus’ postings:

Prologue
Over the past few months, I’ve been working on a series of videos for my Youtube channel focusing on a new user tutorial for openHAB 2. For these videos, I’ve developed a number of slides and a script, with the original intention of using them to create my videos. That said, these should be useful as standalone products, as a new user toturial, to explain the basic concepts of openHAB 2 configuration. As requested by @rlkoshak in the PaperUI-NG / Beginner's Tutorial wiki post, I’m post…

This is a thread to discuss and collaborate on the construction of the docs for PaperUI-NG. The scope for these docs extend beyond just documenting the UI. @David_Graeff’s vision is

That persons first contact with OH will be the website interface instead. I see the responsibility on that interface to teach the user the core concepts of OH and where to find them within the interface.

So not only do we need to cover the UI itself, we need to develop a full Beginner’s Tutorial to include many of the information included in the Concepts section of the current docs.

After installation this will be our first impression to new users. Let’s all work to make it a good one.

For drawings, please use Draw.io. For better or worse, that is the drawing tool selected for OH docs. It saves the drawings in XML so we can source control an editable version of it though which is nice.

@Confectrician, do we have standards we should take into consideration here like image resolutions, color schemes, formats, etc?

Once we get a rough draft, we will move the docs to the appropriate location in github and edit it there.

Docs start here

I have added some of the texts and images to Paper UI NG and also experimented with embedded youtube videos. Not covered are Standalone Scripts, Scheduled-Tasks and control interfaces. And Rules is incomplete in that there is no linked YT video nor any images etc.