Interactive "demo" for the UI

Problem/Justification
Tooltips and online documentation do not always suffice for learning and understanding the features (or lack thereof), layout, functions, and other elements of the TrueNAS web UI.

Some users, such as myself, are hands-on visual learners.


Impact
Meteor from space.
Easier learning, troubleshooting, and following or sharing instructions, even as the product changes and grows with each iteration.

New users can explore the UI without first having to commit to an installation, whether virtualized or bare metal.

Existing users can explore the UI without tinkering around with their own system. They can also provide useful troubleshooting, even if they are physically away from their server. (Since the “demo” will be on the TrueNAS website.)

Core users (for now) can assist with troubleshooting, since this allows them to explore and “use” the SCALE UI.

Users in general can locate typos and give feedback to the developers, specifically concerning the UI.

iXsystems can earn “cool points” and give each other high-fives, or something… I don’t know.


User Story
It’s a good idea.

User story? I’m not sure how to fill in this part.

“It all started when I was just a wee lad…”


An online interactive UI “demo”

I found this excellent post by a legendary user from the old forums, so I’m going to link to it and paste the contents in here again, with some minor edits. (With his permission, of course. He told me in a DM that it’s okay.)


Here is an example of this concept:
:point_down: :point_down: :point_down: :point_down: :point_down: :point_down: :point_down: :point_down: :point_down: :point_down:
:point_right: Try it right now! :point_left:
:point_up_2: :point_up_2: :point_up_2: :point_up_2: :point_up_2: :point_up_2: :point_up_2: :point_up_2: :point_up_2: :point_up_2:


Hear me out: It would only be the surface UI elements of the TrueNAS GUI.

Nothing “virtual”. Nothing runs in the background. Just a simple “clickable” skeleton web page. (A “guided” interactive tour where the visitor can explore on their own.)

This would allow users, new and longstanding, to explore the web UI with each iteration of TrueNAS SCALE.

No need to hunt the web for screenshots of different menus and pages. No need to install on a VM. (Core users, such as myself, can help with surface-level problems for SCALE users.)

Sure, we have the “Docs”, but they are a hit-or-miss, nor do they offer the “hands on feel” that you get from an interactive demo UI.

This tool can also be used to assist in troubleshooting, as well as finding superficial “bugs” such as tooltip typos or inaccurate wording.

Is this even feasible? Is the web UI portion of the codebase “detachable” in a sense that it can be broken off as an interactive “dummy” website? Wouldn’t it be very lightweight?


The first 20 votes will be entered into a lottery, where the winner will be gifted a slightly used 160-GiB PATA harddrive.[1]


Feedback

“I think this idea is le great! It’s worth more than a buttered baguette, fresh out of Momma’s bakery.”
- Monsieur Stux :fr:

“No question. We WILL get started on this as soon as possible. Why? Because it’s a Winnie request. He makes a request, I automatically accept it. That’s how much I respect him. What a superstar.”
- Kris

“Please don’t do this! Our users will totally abandon us for TrueNAS!”
- Synology, QNAP, and Unraid


  1. * IDE ribben cable not included. ↩︎

6 Likes

Damn, you got me.

1 Like

I guess no one wants to claim their free PATA harddrive? Tough crowd, tough crowd…

1 Like

Tplink also does online emulators for their routers and is very helpful.

1 Like

We all agree its desirable to have a demo. For our customers, we have a dedicated lab set-up with physical NAS machines and clients they can use to test configurations and failovers.

To reduce dev resources, the ideal would be just to provide some VMs that users can work with.

Challenges tend to be around the need for storage to emulate. How many virtual drives is enough?

Is a client needed to show activity/success?

Does a user have to setup a whole system each time … or start with a preconfigured system? or both choices?

Happy for Community contributions if someone would like a project…

… I was there. I saw it all happen.


I voted just to complete my NAS on that 286 am not using, so, I need that drive :pray:

2 Likes