Tutorialecke (Blockly/Skripte)

[Andreios]

@smarthome2020 sagte in Tutorialecke (Blockly/Skripte):

Hi,
mir fällt schon seit langer Zeit immer wieder auf, dass sich Fragen häufen, die mit Blockly zu tun haben. Häufig wird gefragt, wie man zB eine Lampensteuerung mit Bewegungsmelder realisiert oder wie man eine "Zeitschaltuhr" programmiert. Ich selber habe aufgrund fehlender Suchergebnisse schon so manchen Thread eröffnet, wo ich dann freundlicherweise auf einen anderen Thread verwiesen wurde.

Aktuell finde ich es schwer, passende Lösungswege über die Suche ausfindig zu machen. Die Schlüsselworte müssen für die Suche sowohl von der Person, die den Thread erstellt hat, als auch von der Person, die das Thema sucht, richtig gesetzt/genutzt werden.
Daher ist mein Vorschlag: Vielleicht kann man eine Tutorialrubrik erstellen. Hier vllt dann noch Unterkategorien, so dass lernwillige/Lösungssuchende vielleicht zuerst in der Tutorialecke schauen bevor sie einen Thread aufmachen.
Die Tutorials laden dann sicher auch noch zum Nachbauen ein.

Hier wäre es dann gut, wenn die "Beispielblocklys" erläutert werden, damit sie verstanden werden können. Sonst wird nachher nur Copy und Paste betrieben, was auf lange Sicht nicht sonderlich nützlich ist.

Was haltet ihr davon?

Die Tutorial-Ecke ist in der Doku vorgesehen, leider nicht gefüllt.
Grundsätzlich bin ich zwar der Meinung, dass die Doku mitbringen sollte, ohne extra einen Punkt "Tutorials", aber wenn, dann sollte es wohl eher dort angesiedelt sein. Meiner Meinung nach die Tutorials dann in den Unterpunkten zu den einzelnen Doku-Teilen.
Also Blockly/Skripte eigentlich erst einmal in der Doku: https://www.iobroker.net/#de/documentation/logic/README.md, natürlich dort unter dem entsprechenden Namen!

Allerdings wird nichts die Fragen hier im Forum verhindern, da die meisten Menschen den einfachsten Weg wählen und der ist eben, das man einfach fragt, statt selber zu suchen. Irgendwer wird die Antwort schon wissen. Das ist jetzt nicht negativ gemeint, die IT-Welt hat sich, u.a. durch die (a)sozialen Medien, geändert und viele stellen schneller mal 'ne Frage, als sich mit einer Suchmaschine zu beschäftigen oder in der Doku zu lesen.

Was ich in anderen Foren schon gesehen habe, darf IMHO nicht passieren, nämlich dass auf die Doku verwiesen wird mit dem Hinweis, dass man ja zu doof ist, in der Doku nachzulesen!
Aber in die Antwort freundlich den Link zum Thema in der Doku / im Tutorial einfließen zu lassen finde ich dann hilfreich. Dann hat der Frager zumindest die Möglichkeit, sich über die Antwort hinaus zu informieren.
Zudem wird sich dann bei Nachfragen herausstellen, wo die Doku verbessert werden kann.

[smarthome2020]

@andreas-5
Ich glaube aber , dass man für viele Standardsituationen ein Beispielblockly basteln kann. Ich stelle mir das ja eher als „Katalog“ mit Beispielen vor.
Es wird darauf hinauslaufen, dass viele sich nicht durch seitenlange Texte quälen.

Wüsste also nicht, was es für einen Nachteil hat. Außerdem bringt es neue User auf Ideen, was diese noch alles verwirklichen könnten.

[Andreios]

@smarthome2020 Ich habe es ja nicht ablehnend gemeint, nur dass ich finde, dass nicht ein Tutorial in der Doku und eins im Forum existieren sollte!
Zudem gehört ein Tutorial, meiner Meinung nach, eher in die Doku, als in ein Forum.
Im Forum gibt es schon eine Script-Ecke und die nicht nur für Blockly!

[Haifeif 0]

@ alle

Hallo. Als Newbie bin ich hier gelandet. Ratet warum? Klar, ich habe etwas zu Blockly gesucht und das Forum / diesen Zweig gefunden.

Ich möchte mich Andreas 5 anschließen: Ein Tutorial gehört nicht in ein Forum. Das in der Doku dafür Platz vorgesehen ist, habe ich bisher nicht gewusst - wahrscheinlich, weil ich noch nie darüber gestolpert bin.

Aus meiner Sicht gibt es 2 Arten von Tutorials: Text mit Screenshots oder Video. Ich liebe Youtube Tutorials, wenn der Autor ein paar grundlegende Regeln beachtet. Die Text / Screenshot Variante hat auch Charme, ist aber aus meiner Sicht sehr viel aufwändiger für beide: den Erstellenden und den Nachvollziehenden. Komplizierte Sache mit Worten so beschreiben, dass eine mir fremde Person mit unbekanntem Wissenstand meine Ausführung vollständig nachvollziehen kann? Haben wir 30 Jahre lang probiert und nicht wirklich perfekt hinbekommen.

Mache ich das selbe mit einem Screenrecording und erkläre dabei in Deutsch, was ich warum wie tue, kommen alle weiter.

Zurück zum Thema: Eine Videosammlung von bewusst kurz gehaltenen Videoclips zum Thema Blockly wäre Klasse! Keine 20 Minuten Tutorials, sondern einzelne Lösungen.

Beispiel: Treppenlichtautomat mit Bewegungsmelder an drei Stellen.

Am Anfang des Videos die Funktion mit einer Kamera zeigen.
Dann die Funktion als Flussdiagramm skizzieren - Welche Infos brauche ich, welche IOBroker Komponenten. Handskizze reicht völlig.
Dann das Blockly entwickeln, und genau erklären, warum nehme ich genau DEN Trigger (und nicht den anderen), warum nehme ich eine Variable und keinen Datenpunkt, usw.

Als Suchkriterium: Die Funktion -Treppenlicht Automation- und die Aktoren/Sensoren - Bewegungs Sensor - würde ich mir wünschen. Der Ablageort für diese Videos: Youtube, ...

PS: Das mit den Clips würde ich mir auch für VIS, FLOT und andere Bereiche wünschen!

[Homoran]

@haifeif-0 ich glaube ihr versprecht euch / erwartet zu viel von Tutorials.
Tutorials können unmöglich für jedes einzelne mögliche Szenario (um bei Blockly zu bleiben) erstellt werden.
Solche Tutorials können höchstens ganz allgemein den Aufbau eines Blocklys behandeln.
Welche Struktur (Trigger - Logik - Mache) o.ä.

Videos wird es mit Sicherheit nicht geben.
Die sind veraltet, bevor sie fertig sind.

im alten Forum sah das etwa so aus

für die Skripte (Blockly gab es noch nicht) gab es Scripte ins Snippets zum Download

[Haifeif 0]

@homoran
Genau! Deswegen habe ich auch (Video-) Clips gemeint. Tutorial für das Grundverständnis, Text&Screenshots oder Youtube.
Clips: 2-3 Minuten, 1 Lösung mit Erklärung warum und wie.

Wenn es dann mal 5 Minuten werden, ich auch nicht schlimm.

Ich hatte ein Problem mit Blockly. Ich wollte einen Text - je nach Messwert grün, gelb oder rot einfärben. Ich habe mir etliche 20 Minuten "Tutorials" angeschaut - ohne Erfolg. Die Lösung hab ich dann durch Zufall in einem Forumstext gefunden - zu einem völlig anderen Thema! Das als 2 Minuten Video wäre Extraklasse gewesen!

[Haifeif 0]

@homoran
Autsch!

Das ist natürlich ein Thema. Verändert sich Blockly so schnell?

[Homoran]

@haifeif-0 sagte in Tutorialecke (Blockly/Skripte):

@homoran
Autsch!

Das ist natürlich ein Thema. Verändert sich Blockly so schnell?

vieles ändert sich sehr schnell
und sehr viele Videos auf YT sind vollkommen veraltet, abgesehen davon, dass etliche auch inhaltlich falsch sind.

Der Aufwand steht in keinem Verhältnis zum Effekt.

Was man gena daran sieht, dass diese alten, falschen Vidros nicht gepflegt werden.

[Haifeif 0]

@homoran

Ich verstehe smarthome 2020. Und Du hast auch Recht. Wie kann also eine machbare Lösung aussehen?

Ich würde mir einen "Support" mit 2 Leveln wünschen: Level 1 Newbies, auf der Grundlage Erklärung und Beispiel. Level 2 Leute, die JS beherrschen, Adapter schreiben usw. und untereinander Fachsimpeln können, ohne Zeit mit Erklärungen zu verbringen.

Support hat auch 2 Gesichter: Hilfe und Hilfe zur Selbsthilfe. Ich bevorzuge zweites, der Aufwand ist zu Beginn möglicherweise etwas höher. aber langfristig erkläre ich nicht 15x wie es geht, sondern mache einen Clip, der es zeigt.

Für den Level 1 stellen sich Aufgaben wie: Erkläre einem Bäckergesellen, der seine Heizung smart machen will, was der Unterschied zwischen STATE und SWITCH in VIS ist. Dafür brauche ich 3 Minuten, mit Beispiel, und habe es so erklärt, dass ein Nicht-Nerd es versteht. (Meistens jedenfalls )

[Homoran]

@haifeif-0 sagte in Tutorialecke (Blockly/Skripte):

Support hat auch 2 Gesichter: Hilfe und Hilfe zur Selbsthilfe. Ich bevorzuge zweites,

Es gibt tatsächlich user, die erwarten hier eine Auftragsprogammierung.
Da fängt dann der Post an mit "Ich brauche ein Skript für...."

wie @smarthome2020 richtig schreibt lernt man dann nix und muss immer wieder andere bemühen.

Ich selber mache mich dann gerne unbeliebt, indem ich immer wieder mit nachfragen statt vorsagen die user dazu bewegen versuche sich zu bemühen das System zu verstehen.

In vielen Fällen ist es gar nich das "ich kann kein java.." sondern es fehlt oft nur an einer strukturierten Herangehensweise.

[smarthome2020]

Nehmen wir mal an, dass Tutorials in die Doku kommen… welche sollen das dann werden? Wer schreibt sie ?
Ich finde es halt wirklichem sehr schade, dass Member wie @paul53 immer wieder gleiche Dinge erklären.
Wenn die Grundelemente des Blocklys in der Doku erklärt werden, dann sehe ich das ja ein. Aber bspw. eine Lampenschaltung?
Letztlich gibt es diese Tutorials alle schon im Forum, nur finden die Suchenden diese nicht. Daher die Idee für die Rubrik .

[crunchip]

@smarthome2020 sagte in Tutorialecke (Blockly/Skripte):

Wer schreibt sie ?

Wer möchte, jeder darf

@smarthome2020 sagte in Tutorialecke (Blockly/Skripte):

Wenn die Grundelemente des Blocklys in der Doku erklärt werden

Oder man liest die readme zum Adapter und findet da schon einiges
https://github.com/ioBroker/ioBroker.javascript/blob/master/docs/de/blockly.md

[Homoran]

@smarthome2020 sagte in Tutorialecke (Blockly/Skripte):

Aber bspw. eine Lampenschaltung?

was willst du uns damit sagen?

sollen jetzt wirklich 298 Tutorials in die Doku?
für Lampenschaltung mit und ohne Bewegungsmelder, mit ein, zwei drei Tastern, mit Tastern von Ikea, Homematic, shelly, mit nächtlicher Dimmung, Bewegung, aber nicht vor Sonnenuntergang....?

[Asgothian]

@homoran sagte in Tutorialecke (Blockly/Skripte):

was willst du uns damit sagen?
sollen jetzt wirklich 298 Tutorials in die Doku?

Ich halte wenig davon detaillierte Tutorials in der Form bereitgestellt zu halten. Allerdings macht es Sinn für bestimmte Anwendungsfälle Beispiele vorzuhalten. Was mir vorschwebt sind (kommentierte) Beispiele zu:

• Trigger mit erweiterten Bedingungen (Status von weiteren Datenpunkten, Ursprung der Anpassung, Zugriff auf aktuellen und/oder vorherigen Wert
• Verzögerte Aktionen (sauber)
• Aktionen für eine Zeit blockieren
• "Entprellen"

Ich wäre auch bereit Beispiele zur Verfügung zu stellen - nach einem Hinweis wo sie hin sollen.

A.

[Homoran]

@asgothian sagte in Tutorialecke (Blockly/Skripte):

Ich halte wenig davon detaillierte Tutorials in der Form bereitgestellt zu halten. Allerdings macht es Sinn für bestimmte Anwendungsfälle Beispiele vorzuhalten. Was mir vorschwebt sind (kommentierte) Beispiele zu:

sieh dir mal dieses an
https://forum.iobroker.net/topic/51757/tutorialecke-blockly-skripte/6?_=1643702145226

das ist, was ich in der alten Doku angefangen hatte.

Tutorials für allgemeine Grundlagen. (Und nur das ergibt für mich einen Sinn)
und in einem anderen Sektor einzelne Skriptbeispiele.

Für letzteres müsste noch die Struktur geschaffen werden.
wobei die Gefahr besteht, dass dann eine c&p Mentalität gefördert wird.

[smarthome2020]

@homoran
Aus meiner Sicht soll auch nicht für alles ein Tutorial erstellt werden.
Nur halt ein Grundbeispiel für zB eine saubere Lampenschaltung mit Bewegungsmelder und Timeout. Das Ganze dann dokumentiert in Einzelschritten.
Daran kann man dann die Grundidee nachvollziehen. Transferleistung für mehr muss man schon aufbringen, das kommt aber von alleine.

[Homoran]

@smarthome2020 sagte in Tutorialecke (Blockly/Skripte):

Nur halt ein Grundbeispiel für zB eine saubere Lampenschaltung mit Bewegungsmelder und Timeout.

Warum gerade dieses doch sehr hardwareabhängige und schon ziemlich komplexe Beispiel?

@smarthome2020 sagte in Tutorialecke (Blockly/Skripte):

Das Ganze dann dokumentiert in Einzelschritten.

Auf jeden Fall! So war das damals auch in der Doku - muss mal suchen was das war.
War ein typisches Wenn - Dann Beispiel, das man heute mit Rules machen würde

[smarthome2020]

@homoran
Das Beispiel Lampensteuerung deswegen, weil ich es gefühlt schon 1000x gelesen habe .
In den Titel muss man dann halt Lampensteuerung , Bewegungsmelder , Timeout integrieren . Man muss/soll die Hardware ja nicht explizit einbinden , den Datenpunkt muss jeder selber finden.

[Homoran]

@smarthome2020 sagte in Tutorialecke (Blockly/Skripte):

Das Beispiel Lampensteuerung deswegen, weil ich es gefühlt schon 1000x gelesen habe .

aber das ist dann in meinen Augen kein allgemeines Beispiel zum Aufbau eines Bloklys.

Und diese gefühlt 1000 Threads dazu kommen eben genau daher, dass jede Installation (bis auf wenige Ausnahmen) unterschiedliche Anforderungen, unterschiedliche Hardware und entsprechend unterschiedliche Anbindungen benötigten.

Genau deswegen halte ich es nicht als geeignetes Beispiel für ein Tutorial.
Die Anzahl Threads wird sich vermutlich nicht verringern. Diese werden dann beginnen mit: "Das Tutorial funktioniert nicht..."

[smarthome2020]

@Homoran
Es liegt aber wahrscheinlich häufig auch daran, dass die Beispiele für die Schaltungen nicht kommentiert sind .