Anregung Thema Updates
-
@ro75
Das Thema update ist für mich auch nicht durchsichtig. Kleines Beispiel: VIS1, Mit Version 1.4.16 läuft bei mir die Visualisireung noch auf meinem IPAD. Mit Version 1.5.1 auch, aber deutlich langsamer. Mit Version 1.5.4 läuft das gar nicht mehr. Ich muss dazu sagen das dieses IPAD ein 10Jahre altes Teil ist.
Ich habe jetzt ein zweites System aufgesetzt bei dem ich Teste ob alle meine gewünschten Funktionen laufen. Ich bin auch eher ein update muffel.
IOBroker betreibe ich erst seit knapp 3 Monaten. In dieser Zeit kamen schon etliche update. Wenn ich das oder die Systeme aktuell halten will, muss ich mindestens wöchentlich nachsehen. Na ja, jetzt macht es noch Spass aber in einem Jahr weiss ich nicht ob das so ist. -
Zuerst mal DANKE für dein Posting / Feedback.
Wenn ich es richtig verstanden habe gibt es aus seiner Sicht 2 Probleme
a) Nach einem Update funktioniert etwas nicht
b) Die Releasenotes sind zu kurz
ad a)
Hier wäre zunächst einmal die Information wichtig ob du von Adaptern im Stable sprichst oder von Latest updates. Latest Updates sind Beta Versionen - da kann es immer mal zu Problemen kommen. Bei Updates von Stable Release sollte die eigentlich nicht passieren. Da für die Qualität eines Adapters in letzter Instanz der jeweilige Entwickler verantwortlich ist kann wahrscheinlich nur er erläutern was passiert ist. Bei Alexa2 hat meines Wissens nach Amazon immer wieder was - auch kurzfristig - geändert. Aber wie gesagt kann da @Apollon77 wahrscheinlich mehr sagen.ad b)
Die Releasenotes schreiben die jeweiligen Entwickler. Leider halten sich hier manche Devs sehr kurz. Ich kenne auch einen Entwickler der sich mehr oder weniger weigert im README.md auf Github überhaupt Changes einzutragen. Da ioBroker nicht zentral gemanged wird, können wir hier nur drängen aber nicht wirklich viel machen. Ganz ohne Releasenotes übernehme ich eine neue Release nicht in Stable. Aber sollen wir Adapter die an sich funktionieren und zahlreich installiert sind ganz aus den Repositories werfen? Ich glaube da gäbe es auch einen Aufschrei. Auch hier im Forum hab ich schon gelesen "Ah die Release ist nicht im Stable wegen formaler Mängel - egal, hauptsache sie funktioniert. Ich installier dann halt latest."Ich kann nur anregen
-) bei einem Fehler UNBEDINGT ein Issue zu eröffnen. Ich check bei jedem Stable Update ob gravierende neue Issues existieren und frage ggF nach.
-) bei mangelhaften Releasenotes den Dev zu quälen, durchaus auhch via Issue oder via Forum. Nur durch Feedback der User wird sich was ändern.Und noch was zu den Releasenotinfos die Admin anziegt vs Github:
- Im Standardablauf schreibt der Entwickler in englischer Sprache die jeweiligen Änderungen als Changelog ins README.md auf GitHub.
- Das standard Releasescript extrahiert diese INformationen und trägt sie als news in io-package.json ein. Dabei erfolgt eine automatische Übersetzung.
- Der Entwickler hat die Möglichkeit vor dem Releasen die automatisch übersetzten Texte zu korrigieren.
Alternativ kann der Entwickler den Releasevorgang auch manuell durchführen und die Texte direkt in io-package.json eintragen (ohne automatische Übersetzung).
Admin zeigt nunmehr die Releasenotes defaultmäßig in englisher Sprache an. Der User kann seine Systemsprache durch anklicken der Erdkugel am oberen Rand auswählen. Er sieht dann - sofern eine Übersetzung für seine Sprache verfügbar ist - den manuell vom Entwickler eingegebenen Test oder eine automatische Übersetzung.
Falls du oder sonst wer Anregungen hat wie man die Qualität der Releasenoets verbessern kann, sprich wie man die Entwickler dazu bringen kann diese genauer und ausführlicher zu schreiben bitte her damit. Ein manuelle Review jeder Latest Release vor der Veröffentlichung ist zeitlich nicht umsetzbar. Und die Frage was mit einer Release / Adapter geschehen soll, dessen Doku und / oder Releasenotes zu minimal sind wäre auch zu klären. Ich habe dazu derzeit keine Lösung.
mcm1957
P.S: Falls jemand Kontakt zu DEEPL hat und ev. ein Sponsoring erreichen kann - eine bessere automatische Übersetzung wär immer willkommen. Nur kommerziell gekauft ist niht finanzierbar.
-
@mcm57 sagte in Anregung Thema Updates:
Hier wäre zunächst einmal die Information wichtig ob du von Adaptern im Stable sprichst oder von Latest updates.
Also generell von Stable. Jüngstes Beispiel "Zigbee". Ich bin jetzt bei 1.9.5 und werde mich, obwohl 1.10.x angeboten wird bei dieser Version bleiben. Warum? Selbst bei der neuen, in Stable befindlichen Version, scheint es jede Menge Probleme zu geben. Bei diesem Beispiel wäre ich wieder bei meinem Ausgangspost.
Mir geht es einfach nur um ein paar mehr Informationen. Also was wird besser? Wo geht ggfs. die Reise hin. Worauf muss ich ggfs. zukünftig achten? Und und und.
Für mich wäre z.B. von interesse: Was bedeutet im Web, WS-Adapter
• update websocket library to increase maximum file size from 100 MB to 500 MB ??Im Moment einfach nur Text. Konkret in diesem Fall interessiert mich das "warum". Was ist denn damit für mich besser? Warum ist das wichtig? Was ergibt sich daraus?
Ich kann mir jetzt vieles zusammen reimen was ggfs. stimmen kann oder total falsch ist. Daraus ergeben sich für meine "Entwicklung" mit der VIS und JS in zukunft richtige oder falsche Wege die ich beschreite. Und genau aus dem "Unwissen" will ich halt selbst produzierten "Müll" vermeiden.
Ro75.
-
@ro75 sagte in Anregung Thema Updates:
Für mich wäre z.B. von interesse: Was bedeutet im Web, WS-Adapter
• update websocket library to increase maximum file size from 100 MB to 500 MB ??Ja, gutes Beispiel. Wo soll man ansetzen? Endnutzern erklären, was Websockets sind? Wozu diese im Adapter genutzt werden? Was für Auswirkungen das hat? Das würde ja total den Rahmen sprengen. Da fängt man ja sonst wo an. Hier wäre eher die Frage, ob die Changelogs so technisch sein müssen.
@ro75 sagte in Anregung Thema Updates:
Selbst auf GIT ist da nicht mehr zu lesen.
Na im Zweifel kannst Du ein Diff von einem Tag zum nächsten ziehen. Und siehst dann ganz genau was sich geändert hat. Viel genauer geht es gar nicht
Generell arbeiten die meisten hoffentlich nach https://semver.org/lang/de/
@ro75 sagte in Anregung Thema Updates:
Ich bin jetzt bei 1.9.5 und werde mich, obwohl 1.10.x angeboten wird bei dieser Version bleiben
https://github.com/ioBroker/ioBroker.zigbee/compare/v1.9.5...v1.10.2
-
@ro75 sagte in Anregung Thema Updates:
Selbst bei der neuen, in Stable befindlichen Version, scheint es jede Menge Probleme zu geben.
Scheint es Probleme zu geben oder hast du konkret ein Problem? Bei den Issues gibt es jedenfalls nichts, was darauf hindeuten würde das es mit der aktuellen Version ein besonderes Problem gibt.
Ein Entwickler kann dir kein für dein System maßgeschneidertes ChangeLog schreiben.
-
@haus-automatisierung sagte in Anregung Thema Updates:
Ja, gutes Beispiel.
schön,
@haus-automatisierung sagte in Anregung Thema Updates:
Wo soll man ansetzen? Endnutzern erklären, was Websockets sind?
nee, so etwas gehört in Newbie-Level in die Adapterdoku, nicht in den change-log
@haus-automatisierung sagte in Anregung Thema Updates:
Wozu diese im Adapter genutzt werden?
dito!
@haus-automatisierung sagte in Anregung Thema Updates:
Was für Auswirkungen das hat?
wenn mit das die Erhöhung des Speichers gemrnt ist, ja!
-
@ro75 sagte in Anregung Thema Updates:
Für mich wäre z.B. von interesse: Was bedeutet im Web, WS-Adapter
• update websocket library to increase maximum file size from 100 MB to 500 MB ??Die Antwort auf deine Frage, was hinter dieser Änderung steckt ist dieses issue https://github.com/ioBroker/ioBroker.vis-2/issues/254
Ich weiß es aber auch nur, weil ich das issue kannte
Beim vis-2 Adapter schreibt @foxriver76 in seine commits eigentlich immer rein, welches issue mit dem commit geschlossen wird (https://github.com/ioBroker/ioBroker.vis-2/commits/master/) Dieses Vorgehen ist aber bei den einzelnen Entwicklern unterschiedlich. Wenn dich Details interessieren, wäre der erste Weg in die commits zu schauen, ob der Entwickler dort etwas verlinkt / dokumentiert hat.
-
@thomas-braun sagte in Anregung Thema Updates:
Scheint es Probleme zu geben oder hast du konkret ein Problem? Bei den Issues gibt es jedenfalls nichts, was darauf hindeuten würde das es mit der aktuellen Version ein besonderes Problem gibt.
Ich lese halt viel, besonders das, was mich auch direkt betreffen könnte Beispiel
Ro75.
-
@Ro75 ich verstehe das Problem mit den Update infos die im Admin angezeigt werden. Ich bin inzwischen davon weg gegangen diese in allen Sprachen an zu bieten und sie Automatisiert zu Übersetzen.
Bei aller Mühe die Infos Aussagekräftig zu machen, ist es schwierig alle nötigen Infos zu Transportieren damit genug Kontext dabei ist.
Weshalb auch einige Entwickler den Issue auf Github verlinken, so fern es einen gibt.
Zugegeben weis ich gerade nicht ob diese Links im Admin dann Klickbar sind. Aber die Nummern sieht man und nach denen kann man suchen im Adapter repo, so bekommt man mehr infos.@ro75 sagte in Anregung Thema Updates:
Hier stimme ich dir zu 100% zu. Aber was bedeutet denn nun konkret
• update websocket library to increase maximum file size from 100 MB to 500 MBMeine Interpretation: Die größe einer Datei die per websocket Übertragen werden kann ist jetzt 500MB statt 100MB.
Für mich als Entwickler wäre es jetzt interessant zu wissen warum du dich mit der Interpretation schwer tust?
Es sind aus meiner sicht alle Informationen vorhanden die es braucht.
Increase = erhöhen/vergrößern
Maximum = maximum/maximal
File size = Datei größe
100MB = alter Wert
500MB = neuer WertNehmen wir jetzt mal an meine Interpretation ist richtig, wie müsste es aus deiner Sicht geschrieben sein das du es gleichermaßen verstehst?
Vielleicht lässt sich so ja ein Leitfaden erarbeiten wie man solche Infos Formulieren muss damit sie die Mehrheit der Benutzer auch verstehen kann. -
@jey-cee sagte in Anregung Thema Updates:
Ich bin inzwischen davon weg gegangen diese in allen Sprachen an zu bieten und sie Automatisiert zu Übersetzen.
Im Admin wird das Changelog ja in den aktuellen Versionen sowieso nur noch auf Englisch angezeigt, da die automatischen Übersetzungen nicht unbedingt gut waren
-
@jey-cee wie ich @haus-automatisierung schon antwortete wäre zusätzlich die Info, warum das gemacht wurde interessant.
kam es zu Problemen wegen zu wenig Speicher?
läuft der Adapter jetzt zügiger?Das wird ja nicht zum Spaß gemacht
-
@homoran schau mal in meinen Beitrag
https://forum.iobroker.net/topic/72461/anregung-thema-updates/26 -
@homoran sagte in Anregung Thema Updates:
kam es zu Problemen wegen zu wenig Speicher?
Na die Antwort wäre in dem Falle ja, "weil manche Nutzer wohl größere Projekte importieren wollen, als ursprünglich erwartet". Die Info hilft ja auch nicht wirklich.
"Maximale Projektgröße beim Import wurde von 100MB auf 500MB erhöht" ?
-
@haus-automatisierung sagte in Anregung Thema Updates:
Die Info hilft ja auch nicht wirklich.
aber
Speicher von 100 auf 500MB vergrößert um größere Dateien transportieren zu können
tut doch auch keinem weh und ist in meinen Augen eine vollständige Info
EDIT: wobei ich ehrlich gesagt, file-size vollkommen falsch zugeordnet hatte
-
@homoran sagte in Anregung Thema Updates:
kam es zu Problemen wegen zu wenig Speicher?
läuft der Adapter jetzt zügiger?
Das wird ja nicht zum Spaß gemachtGenau, nicht zum Spaß, sondern da steckt mehr dahinter.
Ro75.
-
@haus-automatisierung sagte in Anregung Thema Updates:
Na die Antwort wäre in dem Falle ja, "weil manche Nutzer wohl größere Projekte importieren wollen, als ursprünglich erwartet". Die Info hilft ja auch nicht wirklich.
Also nicht jeder hat nur eine oder zwei Views. Da haben, mich eingeschlossen, wohl schon einige Views mehr mit einigen Daten. Da ist es für mich schon wichtig ob ich mit allem unter 100MB bleiben muss um keine Probleme zu bekommen oder denen aus dem Weg zu gehen ODER ob ich mit dem Update einfach frei ohne "Besorgnis" weiter machen kann.
ABER dafür brauche ich halt mehr Infos, als nur "einen Knochen hingeworfen zu bekommen" (bildlich dargestellt).
Ro75.
-
@ro75 sagte in Anregung Thema Updates:
Da ist es für mich schon wichtig ob ich mit allem unter 100MB bleiben muss um keine Probleme zu bekommen
Die Info gehört aber in die Dokumentation und nicht in ein Changelog. Manche installieren ja auch erst jetzt VIS und bekommen das Changelog der älteren Versionen nie zu sehen. Du wusstest ja vorher gar nichts von dem 100MB Limit, oder?
-
@ro75 Als normaler Anwender, möchte mich doch um solche Limitierungen im ersten Schritt gar nicht kümmern, wenn sie nicht ausdrücklich in der Doku vom Adapter geanannt sind. Wenn es ein Problem gibt, wird ein issue eröffnet und der Entwickler kann es sich dann anschauen.
-
@ro75 sagte in Anregung Thema Updates:
Da ist es für mich schon wichtig ob ich mit allem unter 100MB bleiben muss um keine Probleme zu bekommen oder denen aus dem Weg zu gehen ODER ob ich mit dem Update einfach frei ohne "Besorgnis" weiter machen kann.
Und das ist genau die Situation die ich hier meinte:
Wenn es mich momentan nicht betrifft ist es mir egal, wenn künftige Probleme mich erst gar nicht betreffen werden ist es mir recht.
-
@haus-automatisierung sagte in Anregung Thema Updates:
Die Info gehört aber in die Dokumentation und nicht in ein Changelog.
List du nach jedem Update die Dokumentation neu durch, ob sich da grundlegende Daten geändert haben?
Ro75.
