Anregung Thema Updates
-
@homoran sagte in Anregung Thema Updates:
Was du hier ansprichst sind die changelogs bem Update der Adapter.
Nicht die eigentliche Doku.
Dazu gab es schon mal einen Thread.
Das "Problem" ist hier tatsächlich die aus dem Entwickler-Repo in den admin übernommene Version des changelogs, die dort nur in Englisch existiert.
Diese wird automatisiert mehr oder weniger glücklich übersetzt.
Eine Belassung in Englisch ist aber auch nicht gewünscht. Es gibt genug User die des Englischen nicht mächtig sind.
Frei nach dem Motto: Früher war alles viel besser könnte man die Vorführung des Changelogs auch wieder ganz weglassen.Genau das ist es.
Interessierte könnten sich das Changelog auf GitHub ansehen.
Nur da habe ich (bisher) auch nicht mehr gefunden.
Ro75.
-
@ro75 sagte in Anregung Thema Updates:
Nur da habe ich (bisher) auch nicht mehr gefunden.
gibt es auch nicht!
Aber die Irritationen im Admin wären weg
-
@ro75 sagte in Anregung Thema Updates:
Mir persönlich fehlen halt die Details, die Zusammenhänge.
Dann schau im GitHub durch die Commits, da kannst du alles nachvollziehen.
Die Details und technischen Zusammenhänge kannst du in ChangeNotes eh nicht vollumfänglich reinpacken.Kurze Hinweise, an welcher Stelle was getan wurde reicht eigentlich aus.
Für Interessierte ist der Hinweis genug, für die anderen ist es so detailliert schon wieder fast entbehrlich. -
@homoran sagte in Anregung Thema Updates:
Aber die Irritationen im Admin wären weg
Das wäre mal ein Weg. Im Admin alles kurz und knapp und auf GIT, für Interessierte, mehr Details.
Ro75.
-
@ro75 sagte in Anregung Thema Updates:
@homoran sagte in Anregung Thema Updates:
Aber die Irritationen im Admin wären weg
Das wäre mal ein Weg. Im Admin alles kurz und knapp und auf GIT, für Interessierte, mehr Details.
Ro75.
nee, das geht ja aus den genannten Gründen nicht
-
Wo kann ich anstehende Updates sehen wenn es jetzt den Info-Adapter nicht mehr geben soll?
-
@elektron60
Das sieht man doch in der Adapterübersicht. Der Menüpunkt 'Adapter' hat doch sogar eine kleine farblich unterlegte Zahl mit der Anzahl an updatefähigen Adaptern. -
@elektron60
In der Admin Gui:
Oder als Datenpunkt(e):
-
Ja, richtig. Danke für den Stupser!
-
@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
