ElabNET Technik Forum

Verehrte Nutzer des Timberwolf Servers,

wir machen uns Gedanken zum Offline-Hilfesystem, also zu diejenigen Anzeigen und Hilfetexte, die direkt in der Web-APP (die Benutzeroberfläche) enthalten sind, also nicht Wiki mit Handbuch oder die vormalige Knowledgebase. Gerade bei einem frühem Einsatz auf der Baustelle gibt es nicht unbedingt Internet.


Das derzeitige Offline-Hilfesystem besteht aus

1. Mouse-Over Anzeigen zu Werten usw. mit Zusatzinfo (Nachteil: das wird von touchbasierten Geräten unterschiedlich gehandhabt)

2. Ausklappbare Hilfetexte, wenn man das blaue (i) betätigt

3. Eingeblendete Hinweise, die auch ohne einen Klick eingeblendet sind, meist um auf etwas wichtiges hinzuweisen

4. Bestätigungsfragen, die bei Konfigurationen hoher Tragweite erscheinen und auf die Folgen hinweisen (hier sind die Buttons dann auch blau oder gar rot gefärbt)

5. Toasts (das sind die rechts nach oben fliegenden kleinen Banner, die auch wieder verschwinden) für Bestätigungen oder Hinweise nach Nutzer-Aktionen, für die sich keine anderen Texte eignet

6. Nachrichten / Aufgaben im Nachrichtencenter (für längerfristig gültiges)

7. Offline-Hilfe mit etwas umfangreicherer Einführung und Kurzdokumentationen inkl. Liste weiterführender Links.


Dazu dann noch die Online-Hilfe in Wiki, KB und Forum


Dazu ein paar Detailfragen an Euch (Hinweis: Es sind zwei parallele Themen):

A: Wie soll der Hinweis auf ausklappbare Info-Texte gestaltet sein?

Weil wir fragen uns, wird von einem neuen Nutzer überhaupt erkannt, dass man mit Klick auf das blaue (i) an weitere Informationen kommt, weil darunter ein Text ausklappt? Oder braucht es den brachialeren Hinweis mit der [HILFE] Schaltfläche? Oder gar in der Version, dass ein Text noch darauf hinweist, dass man hier klicken kann?


A1: So wie bisher ist ausreichend, nur das kleine blaue (i)




A2: Ja, bitte den HILFE-Button, sieht man viel besser. Da es eine Schaltfläche ist, versteht man schon, dass man drauf klicken kann




A3: Ja, bitte Hilfe-Button plus einem zum Klicken einladenden Text




A4: Bitte Mischung aus A1 und A3, also zum Klicken einladender Text, aber nur das kleinere blaue (i) (der große Hilfe-Button stört das Bild).



B: Wird die große Offline-Hilfe gewünscht?





Wir hatten ursprünglich im Container-Manager eine umfangreichere Offline Hilfe implementiert, jedoch praktisch keine Reaktion von den Nutzern erhalten. Beim neuen IFTTT Modul haben wir nun einen erneuten Anlauf genommen und wieder eine solche umfangreichere Offline Hilfe implementiert, jedoch auch hier keine Reaktion von den Insidern.

Wir fragen uns nun, ob diese große Offline-Hilfe gewünscht wird (oder überhaupt jemals angeklickt wurde, weil womöglich hat man das gar nicht gewusst).


B1: Ui, das kannte ich noch gar nicht, brauche ich aber nicht, mir war auch so alles klar


B2: Ui, das kannte ich noch gar nicht, das hätte mir beim Start sehr geholfen, bitte in allen Funktionsmodulen


B3: Nein, kenne ich zwar, aber brauche ich nicht. Ich lese lieber gleich die vollständige Doku und sehe das Video dazu (ja, mit ist bekannt, dass es Doku und Video oft erst Wochen nach dem ersten Rollout eines neuen Feature gibt)

B4: Ja, kenne ich und fand ich sehr hilfreich. bitte in allen Funktionsmodulen


Gerne auch Eure Kommentare / Wünsche dazu

lg

Stefan

Ich schwanke zwischen A1 und A2; habe letztlich für A2 gestimmt.

A2 finde ich die bessere Option weil nur das kleine blaue "i" leicht zu übersehen ist. Habe mich allerdings inzwischen daran gewöhnt, nach diesem "i" zu suchen.

Hi Peter,

terseek hat geschrieben: ↑So Jan 08, 2023 11:16 amA2 finde ich die bessere Option weil nur das kleine blaue "i" leicht zu übersehen ist. Habe mich allerdings inzwischen daran gewöhnt, nach diesem "i" zu suchen.

Ja, geht uns genau so.

Für den Neueinsteiger ist sicher der größere Hilfe-Button besser, weil das ist intuitiver, darauf zu klicken, insbesondere mit einladendem Text zum Klick (muss ja nicht überall so sein).

Wer es einmal kennt, dem würde auch das kleine blaue (i) reichen.

Wir haben eben nur auch manchmal Support-Anfragen, insbesondere von neuen Nutzern, da denke ich mir, haben die das überhaupt gelesen? Bzw. gewusst, dass es da was zum Lesen gibt?. Mir haben auch Kunden gesagt, dass sie das große Fragezeichen in der Ecke oben links auch nicht wahrnehmen.

Es ist also nicht nur Aufwand die Texte zu schreiben, sondern auch, dass der Kunde weiß dass es diese gibt.

lg

Stefan

A1 hat zwar den Nachteil, dass Neueinsteiger es erst "entdecken" müssen, hat aber ansonsten nur Vorteile:
- Weniger Platzverbrauch auf dem Bildschirm.
- Kein Text, der übersetzt werden muss.
- Keine Diskussion ob "Hilfe" richtig ist, oder doch lieber "Information" oder "foobar".
Ich finde es vor allem nicht gut dafür dauerhaft mehr Platz zu "verschwenden". Gäbe es nicht vielleicht einen Weg, der nur einmalig die Aufmerksamkeit auf sich lenkt? Synology und einige Smartphone Apps machen es doch so, dass beim ersten Öffnen einer Ansicht Popups auf bestimmte Buttons hinweisen und erst dann verschwinden, wenn man dem Hinweis folgt und die Schaltfläche anklickt. Einige dunkeln dabei sogar alles andere ab oder legen einen blur-Effekt über die restliche Fläche. Das ist aber alles schon wieder viel zu viel Entwicklungsaufwand. Für mich bitte einfach das kleine Icon so lassen.

Thema B: Ich bin grundsätzlich ein großer Freund davon unabhängig von Cloud-Diensten zu sein und da schließe ich die Doku nicht ganz aus. Neben einer Baustelle ohne Internet kann es immer mal vorkommen, dass das Internet oder ein Doku-Server ausfällt oder nicht erreichbar ist oder im Extremfall ein Produkt seinen Anbieter überlebt.
Mir haben die Seiten im Container Manager geholfen und ich hätte mir das auch auf den anderen Seiten gewünscht. Das erleichtert auch Neukunden sicher den Einstieg.
In Anlehnung an mein Argument zu Thema A finde ich es hier auch sehr gelungen, dass diese Infos zu Beginn ausgeklappt waren und dann aber zugeklappt werden können.

Viele Grüße
Lukas


PS: Stefan, ich finde es großartig und unschätzbar wertvoll, dass Elabnet und speziell du hier so stark im Forum aktiv bist! Aber es ist Sonntag. Denk bitte an deine Neujahrsvorsätze.

Klar A2, da gerade Einsteiger diese Hilfen benötigen und den Text vorab schon als Hinweis verstehen, sich höchstens wundern warum das ! hinten dran und nicht vorne weg stand. Das bei Klick noch viel viel mehr Hilfe / Info möglich wäre erschließt sich da kaum.


Zu B:
Beim IFTTT habe ich es gesehen aber ehrlich weil der TWS derzeit immer Online ist, habe ich nicht erkannt ob das nun online oder offline Content ist. Auch wenn Du da erwähntest das im Wiki die IFTTT Doku noch nicht stand.

Also eher B3.

Bei IFTTT und Docker als Beispiele halte ich eine Offline-Hilfe für absolut entbehrlich, weil wie will man sich diese Systeme offline konfigurieren?
Für Docker muss man sich Images laden und IFTTT ohne Internet ergibt gar keinen Sinn.

Und Insider-Club User haben etwas mehr Vorwissen, lesen dann vorab im Forum die Ankündigung zum Test des neuen Features, da steuert Ihr ja auch kleine Hinweise zur Inbetriebnahme ganz neuer Features bei. Und ein solcher TWS bei dem das mal ausprobiert wird gehe ich ganz stark davon aus, das der dann auch Online ist, weil wo hat er da sonst das Update herbekommen. Eine Erstinbetriebnahme eines TWS auf Offline Baustelle und gleichzeitig nagelneuer Insider/Dev Features halte ich für kein oft vorkommendes Szenario was diesen Aufwand rechtfertigen würde die Doku doppelt zu erstellen.

Wenn dann bei Modulen, die wirklich bei einer Erstinbetriebnahme im Offline-Modus brauchbar sind (KNX, 1Wire). Dann aber nur Inbetriebnahme Themen, kein Lexikon.

Zu A):
Oft und häufig bitte A1 mit einem kurzen Text für ein MouseOver der für genau diesen Aspekt etwas mehr Infos gint.
Und dann noch A2 für größere Hilfetexte / Anleitungen, die dann auf einer eigenen Seite liegen (so wie den Inhalt von B)

Zu B):
Als "Zwangshilfe" ist das viel zu viel. Ich kenne es und es nervt mich, dass es mir immer mal wieder erst mal im Weg steht (Platzbedarf).
Ausgeblendet und per Hilfe-Button erscheinbar wäre es aber dann super. Wobei man da noch den Umfang stärker auf das wesentliche konzentrieren sollte, damit er eine wirkliche Hilfe darstellt. So ist der Text (z.B. hier beim Container-Manager) eine komische Mischung aus Werbe-Text und Hilfe:
"Der Timberwolf Server ist sehr leistungsfähig und stellt mehr Ressourcen bereit als von der Timberwolf Server Systemsoftware benötigt werden."
-> Das ist ein reiner Werbe-Text, der Informationsgehalt für eine Hilfe wie man das nutzten kann ist jedoch vernachlässigbar. Für eine Werbung ist's aber die falsche Stelle - wer das hier liest hat ja den TWS schon gekauft...

Grundsätzlich sehe ich einen Vorteil in einem dreistufigen System:
1) Häufig und oft die -Icons mit MouseOver für einen kurzen Hinweis um was es an genau dieser Stelle geht. d.h. die können durchaus öfters auf einer Seite erscheinen
2) Da wo's kompliziert wird ein [info]-Button der eine beschreibende Offline-Seite lädt. Gefühlt (aber keine harte Vorgabe) max. 1x pro Seite, eher 1x pro Funktionsbereich
3) Für weitere, tiefe Informationen, Tutorials, Videos, aber auch ggf. Erratas dann einen Link auf die Online-Hilfe. In der Regel wäre so ein Link auf jeder Offline-Seite. Aber je nach Thema könnte es Sinn machen den auch gleich schon sichtbar zu machen.

StefanW hat geschrieben: ↑So Jan 08, 2023 12:50 pm

terseek hat geschrieben: ↑So Jan 08, 2023 11:16 amA2 finde ich die bessere Option weil nur das kleine blaue "i" leicht zu übersehen ist. Habe mich allerdings inzwischen daran gewöhnt, nach diesem "i" zu suchen.

Ja, geht uns genau so.

Für's MouseOver finde ich den nicht zu übersehen. V.a. ist der genau da wo die Frage auftaucht. Der Scope ist aber halt auch nur für diesen kleinen Abschnitt, ggf. sogar nur für ein einziges Eingabefeld.

StefanW hat geschrieben: ↑So Jan 08, 2023 12:50 pm Für den Neueinsteiger ist sicher der größere Hilfe-Button besser, weil das ist intuitiver, darauf zu klicken, insbesondere mit einladendem Text zum Klick (muss ja nicht überall so sein).
[...]
Mir haben auch Kunden gesagt, dass sie das große Fragezeichen in der Ecke oben links auch nicht wahrnehmen.

Dieses Fragezeichen nehme ich auch nicht wahr.

Vermutlich aufgrund:
- ich such das eher rechts oben als links oben (vielleicht hängt das mit der Lese-Richtung zusammen?)
- optisch sieht der irgendwie nicht so intensiv nach Hilfe aus. Evtl. statt dem einfachen Fragezeichen auch so einen blauen Punkt mit Fragezeichen verwenden? Oder nach "Online-Hilfe" oder "Handbuch" umbenennen?
- es gibt viele Programme die eine Funktion implementiert haben, bei der mit Mausklick auf einen Button der Mauscursor ein Fragezeichen dazu bekommt und ich nun überall auf der Seite Klicken kann um für diese Fläche dort eine Hilfe zu bekommen. ABER: Hinter den aller meisten Flächen liegt keine Hilfe. => Nach dem ich das ein paar mal bei ein paar verschiedenen Programmen gemacht habe, habe ich gelernt, dass das eh nichts bringt und ich es auch nicht mehr versuche. Dieser Fragezeichen-Button sieht genau so aus, wie dieser Button bei den anderen Programmen der mich schon oft enttäuscht hat.

Verehrte Foristen,

diese Umfrage endet in zwei Tagen, wer sich noch nicht beteiligt hat bisher, ist herzlich eingeladen seine Meinung zu diesem wichtigen Hilfe-Feature abzugeben.

lg

Stefan