====== Fehler melden und Wünsche eintragen ====== //Seitenstand 1.00 (2026-11-17), gilt für webMobaLedLib 3.87// Etwas funktioniert nicht, oder dir fehlt eine Funktion? Dann schreib es bitte auf! Nur so erfährt der Entwickler davon, und andere Anwender profitieren mit. Der beste Ort dafür ist der **Issue Tracker** (die Fehlerliste) auf GitHub. Eine Meldung dort heißt **Issue**. Du brauchst dafür **keine Programmierkenntnisse**. Du brauchst nur ein kostenloses **GitHub-Konto**. Wenn du keins haben möchtest, schreibst du ins [[https://forum.mobaledlib.de/viewforum.php?f=14|Forum der MobaLedLib]]. Die Hinweise unten gelten dort genauso. ===== Zuerst: Ist es wirklich ein Fehler? ===== - Schau auf der Seite [[anleitungen:webmobaledlib:fehlersuche|Fehlersuche]] nach, ob dein Problem dort schon beschrieben ist. - Prüfe, ob du die **neueste Version** hast (Menü **Hilfe → Update webMobaLedLib ...**). Viele Fehler sind in einer neueren Version schon behoben. - Suche im [[https://github.com/haroldlinke/WebMLL/issues|Issue Tracker]], ob jemand dasselbe schon gemeldet hat. Wenn ja, schreib dort einen **Kommentar** mit deinen Angaben (siehe unten), statt einen neuen Issue anzulegen. Du kannst auch auf **Subscribe** klicken, dann bekommst du eine E-Mail, wenn sich etwas tut. ===== So legst du einen Issue an ===== - Melde dich bei [[https://github.com|github.com]] an (oder lege mit **Sign up** ein kostenloses Konto an). - Öffne [[https://github.com/haroldlinke/WebMLL/issues|github.com/haroldlinke/WebMLL/issues]]. - Klicke auf den grünen Knopf **New issue**. - Schreibe oben einen **kurzen Titel**, der das Problem in einem Satz sagt. Gut: „Beim Setup übertragen mit Nano alt kommt ‚Keine Antwort‘“. Schlecht: „Geht nicht“. - Beschreibe das Problem im großen Textfeld. Was hineingehört, steht im nächsten Abschnitt. - Ziehe **Dateien und Bilder** mit der Maus in das Textfeld, um sie anzuhängen (siehe unten). - Klicke auf **Submit new issue**. Danach kannst du den Issue jederzeit ergänzen: Unter dem Issue ist ein Feld **Comment**. Der Entwickler oder andere Anwender fragen dort vielleicht nach. Du bekommst jede Antwort per E-Mail. ===== Was in die Meldung gehört ===== Je genauer die Meldung, desto schneller kann jemand helfen. Kopiere diese Vorlage in das Textfeld und fülle sie aus: **Was wollte ich tun?** (zum Beispiel: Ein Programm auf die Lichtmaschine übertragen) **Was ist passiert?** (genaue Meldung, wenn es eine gab; bitte abschreiben oder Bildschirmfoto) **Was hätte passieren sollen?** **So kann man es nachstellen:** 1. ... 2. ... 3. ... **Wie oft?** immer / manchmal / einmal **Meine Umgebung:** - webMobaLedLib-Version: (Menü Hilfe → Über ...) - Betriebssystem: Windows 11 / macOS 14 / Linux ... / Raspberry Pi 5 - Browser: Chrome / Edge / Firefox / Safari (Version) - Lichtmaschine: Classic (Nano) / Pro (ESP32) / Pico Zero / Molli - Entwicklungsumgebung: PlatformIO / ARDUINO IDE Wichtig sind vor allem die **Version** und die **Schritte zum Nachstellen**. Ohne sie lässt sich ein Fehler oft nicht finden. ===== Anhänge: Protokoll, Bild, Tabelle ===== * **Protokoll (am wichtigsten):** Öffne **Hilfe → Logfile anzeigen** und klicke auf **Ganze Datei herunterladen**. Das ist die Datei **webmobaledlib.log**. Hänge sie an den Issue an (ziehen und loslassen). GitHub nimmt **.log**-Dateien an. Gibt es eine Datei **webmobaledlib.log.1**, hänge sie auch an. Wo diese Dateien liegen, steht auf der Seite [[anleitungen:webmobaledlib:aktualisieren#wo_liegt_der_datenordner|Aktualisieren]]. * **Bildschirmfoto:** Bei einer Fehlermeldung oder einer falschen Anzeige hilft ein Bild sehr. Du kannst es mit **Strg+V** direkt in das Textfeld einfügen. * **Deine Tabelle:** Betrifft der Fehler eine bestimmte Tabelle, hänge sie an. GitHub kennt die Endung **.MLL_pgf** nicht. Packe die Datei vorher in ein **ZIP** (Rechtsklick → „Senden an“ → „ZIP-komprimierter Ordner“ unter Windows, „Komprimieren“ auf dem Mac). * **Lange Meldungen im Text:** Setze sie zwischen zwei Zeilen mit je **drei Backticks** (das Zeichen ''`'', auf der deutschen Tastatur Umschalt+Akzenttaste, danach Leertaste), damit sie lesbar bleiben: ``` Hier steht der kopierte Text aus dem Protokoll ``` ===== Bitte nicht veröffentlichen ===== Ein Issue ist **öffentlich**: Jeder im Internet kann ihn lesen. Bevor du etwas anhängst, prüfe deshalb: * **Passwörter:** WLAN-Name und -Passwort, OTA-Passwort und Anmeldedaten für den Raspberry Pi gehören **nicht** in eine Meldung. Suche im Protokoll nach diesen Wörtern und ersetze sie durch „xxx“, bevor du es hochlädst. * **Persönliches:** Auch Benutzername und Ordnernamen (zum Beispiel ''C:\Users\Dein Name'') stehen manchmal im Protokoll. Ersetze sie, wenn du sie nicht veröffentlichen willst. * **Anlagendaten:** Deine Tabelle zeigt, welche Adressen und Effekte du benutzt. Das ist meist harmlos; denke aber daran, bevor du sie anhängst. ===== Wünsche und Ideen ===== Auch Vorschläge sind willkommen, zum Beispiel „Mir fehlt der Multiplexer im Timeline Editor“. Lege dafür ebenfalls einen Issue an. Beschreibe, **was du erreichen willst** (nicht nur, wie es gehen soll), und wenn möglich, wie du es heute in der Excel-Version machst. Ein Beispiel ist der Issue [[https://github.com/haroldlinke/WebMLL/issues/6|MobaLedLib Extensions (MLX)]]. Mehrere Wünsche gehören in **mehrere Issues**, nicht in einen. So kann jeder Wunsch einzeln besprochen und erledigt werden. ===== Was danach passiert ===== * Der Entwickler liest die Meldung und fragt bei Bedarf nach. Bitte antworte, wenn Fragen kommen. Ohne Antwort kann ein Fehler oft nicht gelöst werden. * Ein Fehler wird nachgestellt und behoben. Die Korrektur steht dann in einer **neuen Version**. Im Issue steht, in welcher. Du erhältst sie über **Hilfe → Update webMobaLedLib ...**. Eine Vorabversion zum Testen gibt es unter **Hilfe → Update Testversion ...**. * Wünsche werden gesammelt und nach Aufwand und Nutzen eingeplant. Nicht jeder Wunsch wird umgesetzt, und manche dauern. Der Entwickler schreibt dir den Stand in den Issue. * Ist alles erledigt, wird der Issue **geschlossen** (**Closed**). Funktioniert es bei dir weiterhin nicht, schreib einen Kommentar. Der Issue kann dann wieder geöffnet werden. Du möchtest nicht nur melden, sondern selbst mithelfen? Dann lies die Seite [[anleitungen:webmobaledlib:mitentwickeln|Mitentwickeln]]. ===== Siehe auch ===== * [[anleitungen:webmobaledlib:fehlersuche|Fehlersuche]]: Häufige Probleme und ihre Lösung. * [[anleitungen:webmobaledlib:mitentwickeln|Mitentwickeln]]: Selbst am Programm mitarbeiten. * [[anleitungen:webmobaledlib:aktualisieren|Das Programm aktualisieren]]