Matter Bridge
-
@feuersturm sagte in Matter Bridge:
@martinp auf welcher GitHub Seite hast du den nachgesehen? Hier in der readme steht schon etwas https://github.com/ioBroker/ioBroker.matter und auch das Wiki mit seinen Unterseiten soll im Rahmen der Alpha and Beta Phase weiter mit Leben gefüllt werden
https://github.com/ioBroker/ioBroker.matter/wikiDie Wiki-Seite ist etwas wirr, aber hilfreich.
Unter Description im
README.mdsteht "TODO"
Da 3...5 Sätze in 20 ... 30 Minuten schmieden muss doch möglich sein..MOD-EDIT: unerwünschen Link entschärft!
-
@martinp sagte in Matter Bridge:
Die Wiki-Seite ist etwas wirr, aber hilfreich.
Unter Description imREADME.mdsteht "TODO"
Da 3...5 Sätze in 20 ... 30 Minuten schmieden muss doch möglich sein..es steht dir frei einen pullrequest (auch mit mehr Sätzen und weniger wirr) zu stellen.
Das ist ja der Sinn von open Source -
@homoran sagte in Matter Bridge:
es steht dir frei einen pullrequest (auch mit mehr Sätzen und weniger wirr) zu stellen.
Das ist ja der Sinn von open SourceOkay Ich habe weder Matter Devices, noch einen Matter Koordinator, noch habe ich mich mit dem Matter Adapter näher beschäftigt.
Was qualifiziert mich, da etwas hilfreiches zu schreiben?Ich würde ja, wenn es sich anbietet, Matter Devices kaufen. Aber wenn der Matter Adapter erstmal so eine Black Box ist, motiviert mich das nicht gerade...
Meiner Meinung nach ist der Weg bei einem erfolgreichen Pull Request..
- Sehen eines Problems
- Genug Wissen, um es zu lösen.
- Motivation, sich einzubringen, es zu lösen
- Erstellen eines Pull Requests (was durchaus eine Hürde sein kann)
- einen freundlichen Pull-Request-Reviewer, der sich bereit erklärt, die Änderungen zu mergen ... (in einigen Projekten eine unüberwindliche Hürde, wie man hört, hier bei ioBroker aber aus eigener Erfahrung DEFINITIV NICHT! Mein Pull Request wurde schnell und geräuschlos integriert)
Im Vergleich dazu, dass irgendjemand (der sich bereits mit dem Matter Adapter ausreichend beschäftigt hat!) sich erbarmt, und da für das
README.mdeinen Pull-Request macht, verpuffen alle Erklärungen hier mehr oder weniger mit der Zeit. Sie werden unter allen nachfolgenden Beiträgen vergraben ...MOD-EDIT: unerwünschen Link entschärft!
Wenn es um Schritt 3->4 geht, bin ich gerne bereit, mich einzubringen, wenn jemand, etwas, was ich verwenden könnte hier als Beitrag veröffentlicht ...
Ich habe zwar auch erst 2...3 Pull Requests generiert, aber aus irgendeiner verstaubten Ecke werde ich wohl noch zusammen bekommen. wie ich das damals fabriziert habe
Einfacher wäre natürlich, wenn einer der Project Maintainer, der selber Pushen kann einen Text hier aus dem Forum über die Zwischenablage kopieren würde
-
Was qualifiziert mich, da etwas hilfreiches zu schreiben?
Nichts. Vermutlich ging es auch mehr darum, dass das auch besser unterblieben wäre. Etwas Hoffnung kam beim stillen Mitleser danach ja auch auf:
Ich habe keine Matter Devices, und auch keine Matter Gateways, und kann da sicherlich vom Hörensagen nichts Verlässliches schreiben ...
-
@martinp sagte in Matter Bridge:
Im Vergleich dazu, dass irgendjemand (der sich bereits mit dem Matter Adapter ausreichend beschäftigt hat!) sich erbarmt, und da für das
README.mdeinen Pull-Request macht, verpuffen alle Erklärungen hier mehr oder weniger mit der Zeit. Sie werden unter allen nachfolgenden Beiträgen vergraben ...Der Matter Adapter ist gerade in der Alpha Phase wo die groben Schnitzer mit den Testsystemen identifiziert und von @apollon77 , @Bluefox und @foxriver76 zeitnah gefixt werden. Jeder ist herzlich eingeladen mit seinem Testsystem mitzuwirken. Es gab am Anfang die Festlegung, das für die Alphaphase der Austausch inkl. Logs etc. über Discord läuft bevor die Probleme als issues https://github.com/ioBroker/ioBroker.matter/issues verpackt werden. Wenn man einmal schaut, das bereits 72 issues geschlossen / eingearbeitet wurden sieht man, das an dem Thema gearbeitet wird. Die UI ändert sich teilweise noch von Version zu Version, so dass es zum jetzigen Zeitpunkt im meinen Augen noch zu früh ist eine "saubere" Doku mit vielen Screenshots zu haben.
Ich halte eine Doku für dieses Thema auch für sinnvoll. Diese muss aber mit wachsen und kann nicht schon zu Beginn einer Alphaphase vorhanden sein
-
@feuersturm sagte in Matter Bridge:
so dass es zum jetzigen Zeitpunkt im meinen Augen noch zu früh ist eine "saubere" Doku mit vielen Screenshots zu haben.
was ggf. dazu führen würde jedwede Doku, für die der Dev sich noch Zeit aus den Rippen geschnitten hat, anstelle diese zum Programmieren zu verwenden, wieder einzustampfen.
Es wäre nicht der erste Adapter, der in diesem Stadium von Grund auf neu gebaut wurde.
-
@feuersturm es geht ja nur um ein paar Sätze zum Was.
Bevor man los programmiert sollte man doch wissen, was das Ziel ist.
Wenn man z.b. einen MQTT Adapter programmiert, sollte man doch vorher festlegen, welche Rolle er haben soll,
Client oder Broker, oder konfigurierbar beides. -
Ich glaube die Diskussion (und die Zeit dafür) über gute / schlechte / keine Dokumentation können wir uns hier sparen. JEDER ist eingeladen einen PR zur Verbesserung der Dokumentation zu erstellen. Und wenn du (MartinP) auch keinen Matter Adapter im Einsatz hast so hast du doch sicher 'zig andere bei denen die Dokumentation verbessert werden kann. Einfach dort mal anfangen...
-
@martinp sagte in Matter Bridge:
Bevor man los programmiert sollte man doch wissen, was das Ziel ist.
-
... edited 11 minutes ago
Super, danke ...
Dann ist das Englisch im README selber das Problem?
Ansonsten wäre ja ein Link im Readme auf die "Anwendungsfälle" durchaus eine Lösung um das TODO dort aufzulösen
-
@martinp Das Kapitel gab es vorher schon, ich hab nur ein paar Wörter korrigiert
Die englische Readme waren die ersten wichtigen Infos die aus Entwicklersicht verfasst wurden. Es ist bekannt, das das ganze noch zusammengeführt und vereinheitlicht werden muss. Schritt für Schritt.... -
@feuersturm Ist schade, da das Readme ja der erste Berührungspunkt ist
-
@martinp sagte in Matter Bridge:
... edited 11 minutes ago
aber lesen kannst du?
seit dem 30.november 24 wächst der Beitrag sukzessive!
oder geht es nur ums stänkern?
-
@martinp sagte in Matter Bridge:
@feuersturm Ist schade, da das Readme ja der erste Berührungspunkt ist
ist es das tatsächlich?
gute komplexere Adapter haben ein Wiki
Dieser Inhalt passt nicht in ein Readme.
oder soll in das wirre readme rein: siehe Wiki (wip) -
@homoran Ich will das eigentlich nicht unnötig ausdehnen ...
Bei anderen Adaptern ist das nicht einheitlich gelöst ...Beim Zigbee2mqtt Adapter gibt es einen Link auf die Dokumentation auf der Readme Seite
https://github.com/arteck/ioBroker.zigbee2mqtt
Beim Meross-Adapter stehen da direkt ein paar Zeilen Zusammenfassung
https://github.com/Apollon77/ioBroker.meross
Der Einstiegspunkt den man als erstes Annavigiert ist aber sicherlich nicht eine längliche Deep-URL z. B.
https://github.com/arteck/ioBroker.zigbee2mqtt/blob/main/docs/wiki.md
sondern
https://github.com/arteck/ioBroker.zigbee2mqtt
Das letztere ist auch das, was Tante Google auf Platz 1 anzeigt, wenn man "iobroker zigbee2mqtt" eingibt ...
Ob man jetzt die erste oder zweite Variante wählt ist sicherlich Geschmackssachen und hängt auch von der Komplexität des Treibers ab (ob es überhaupt ein Wiki gibt)...
Ein Link zum Wiki im Readme ist aber sicherlich auffälliger, als der Wiki-Link mit Bordmitteln des Projektes auf Github ...
-
@martinp sagte in Matter Bridge:
Ich will das eigentlich nicht unnötig ausdehnen ...
Dann lass es (zum Wohle aller Mitleser) doch einfach! Man, man, man..... Schreiben um des Schreibens willen oder was soll das werden?
Kannst oder willst Du nicht verstehen? Wir reden hier von einem Adapter im absoluten Alpha-Stadium und Du führst Beispiele seit Jahren etablierter Adapter an. Es wurde schon gesagt, dass sich da praktisch alles nochmal ändern kann. Das Teil ist noch nicht mal endgültig funktional und da kackst wegen irgendwelcher Wiki's oder Readme's rum.
@homoran sagte in Matter Bridge:
oder geht es nur ums stänkern?
Entweder das oder Langeweile, was Besseres würde mir auch nicht einfallen.
-
@samson71 Das ist doch gar nicht böse gemeint - ich sehe nur, dass sich anfangen, die Fragen der Alpha-Tester zu sammeln - da es aber die Wiki-Notizen gibt, hat sich meine Anregung auch erübrigt ... Ist ja auch für die Maintainer der Adapter-Entwicklung schwierig, wenn sie hier immer wieder gleiche Fragen beantworten müssen...
-
@martinp sagte in Matter Bridge:
Das ist doch gar nicht böse gemeint
aber unverschämt fordernd formuliert!
@martinp sagte in Matter Bridge:
Da 3...5 Sätze in 20 ... 30 Minuten schmieden muss doch möglich sein..
Was hast du an alpha nicht verstanden?
Das ist ein pre release für User, die bereit sind sich tiefer in das System einzuarbeiten und den/die Entwickler in der Entwicklung zu unterstützen.
Beginnend mit den Grundfunktionalitäten, über Feintuning, Einbindung verschiedenster Geräte, die der Entwickler gar nicht hat, bis das System so stabil läuft, dass man es als Betaversion allgemein einer größeren Testercommunity übergeben kann, ohne allzuviel Angst haben zu müssen, dass das System komplett abschmiert.
So ein pre Release gibt es extrem selten.
Hier ist es ein sehr komplexer Adapter und es gibt sehr viel potentielle Hardware, die unter einen Hut zu bekommen ist.
Das kann ein Entwickler alleine gar nicht stemmen.@martinp sagte in Matter Bridge:
ich sehe nur, dass sich anfangen, die Fragen der Alpha-Tester zu sammeln
und das ist gut so!
Daran kann der Entwickler dann erkennen, was die Alpha-Tester umtreibt.
Das können andere Sichtweisen sein, oder auch Dinge, die dann in dem Readme übernommen werden müssen, wenn der Adapter weitestgehend fertig ist ind diese Punkte noch gelten.
Ich bezweifle dass solche Fragen noch aufkämen, wenn sie durch ein Readme in eine andere Richtung kanalisiert würden -
@homoran sagte in Matter Bridge:
aber unverschämt fordernd formuliert!
Hmm, wenn das so rübergekommen ist, tut mir das Leid ...
-
Jetzt mal bitte alle wieder beruhigen.
Und ja natürlich wird das TODO aus der Readme noch entfernt und ganz ehrlich ... Aktuell in der Alpha Phase mit dem oben fomulierten Ziel ist mir die Readme egal weil die Alpha Tester sich im Discord persönlich austauschen. Da kommt niemand nur mit der Readme. Und wer es doch jetzt schon tut ist erstmal frech "selbst schuld"
Wie @Feuersturm schon gesagt hat sind einige Themen noch im Fluss und damit schreibe ich lieber Doku am Ende wenn ich weiss was wie genau ist anstelle fünf mal.
Und ggf wird auch zum Start der Beta noch nicht alle Doku perfekt sein, weil das ist ein ganzer Haufen Holz und die Erfahrung zeigt das meistens eh nicht gelesen sondern "gemacht" wird, also ist übrigens auch eins der Ziele das die UI selbst viel schon abfrühstückt. AUch das ist ein grund für Verzögerungen weil wir hier immer iterieren sodass es sinnvoll und verständlich ist bestmöglich.
