[Aufruf] Helft bei der neuen ioBroker-Dokumentation und -Adapter-Referenz mit!
-
Hallo,
nachdem ich mich jetzt seit Ende 2018 mit dem ioBroker auf anraten eines befreundeten Entwicklers beschäftige, muss ich sagen, ne echt coole Nummer die Ihr da auf die Beine gestellt habt.
Leider sind die Anleitungen und Tutorials rund um die einzelnen Adapter etc. recht rudimentär oder hören nach 40% des zu erwarteten Umfangs auf.
Aus diesem Grunde möchte ich mich anbieten einige Bereiche der Dokumentation mit zu überarbeiten, sollte hierbei noch Bedarf bestehen.
Gerade durch den Umfang der IoT-Geräte in meinem Haushalt musste ich mir einiges in den letzten Tagen zusammensuchen und hab einige
Fallstricke kennengelernt.
Aus dem Grund: Wissen teilen ist ne feine Sache.
Was benötigt ihr von mir, damit ich euch bei der Doku unterstützen kann?
-
Super!
Die alte Doku habe ich leider nicht mehr alleine geschafft aktuell zu halten, die Devs entwickeln schneller, als ich tippen kann.
Auch wollen wir schon seit längerem eine andere Basis für die Doku haben, deswegen ist an der alten (fast) nichts mehr gemacht worden. Schon gar nicht mit den neueren Adaptern. (Nur mal so als Entschuldigungsversuch)
Es wird eine Doku geben mit Tutorials und einen Teil mit Adapterreferenz.
Das Problem bei "externen" Quellen war leider, dass ich diese teilweise wegen fehlender Hardware nicht verifiziert habe und auch nicht pflegen konnte.
Wichtig ist daher auch die Kontinuität!
Was für ein Part schwebt dir den vor?
Gruß
Rainer
-
@SolarisMUC Ich schick Dir gleich ne PN
-
Ich denke/hoffe du hast da jetzt was
-
Ja alles im grünen Bereich
-
Hi zusammen,
ich hab vor ca. einem Jahr angefangen mich in das iobroker Thema einzuarbeiten und hab nun auch mittlerweile einiges geschafft und unser Smarthome mit >90 sensoren/aktoren und einigen skripten, adaptern & visualisierung aufgesetzt. Dabei bin ich durch viele unterschiedliche Themen gewandert mit den dazugehörenden Problemen:
-
Iobroker installationen auf unterschiedlichen Platformen, Raspi, VM, Windows & als Docker
-
Unterschiedliche Adapter (Homematic, Alexa, Denon, ical, Dashbuttons, Xiaomi, Zigbee, pilight, milight, spotify, fritzbox usw.)
-
Multihost System mit Synology NAS & Raspi (da CC2531 Stick am Raspi zentral in der Wohnung)
-
Diverse Skripte auf blockly & javascript (Temperatur & Luftfeuchtigkeitsregelung, Beschattungsautomatik, Anwesenheitserkennung, Aquarium Wasserwechselsteuerung, Beleuchtungsautomatik mit Bewegungsmeldern usw.)
Gerne würd ich mein Wissen auch an die Community weiter geben durch die ich selbst so viel gelernt habe.
In der Tat sind die ganzen Informationen teilweise sehr zerstreut in den Foren und Anleitungen zu finden und teilweise auch widersprüchlich (wenn die Adapter sich nicht richtig installieren lassen weil irgendwas fehlt grr)
Vielleicht können wir mal n Termin zum Skypen ausmachen & besprechen wie ich supporten kann.
Grüße,
Matze
-
-
Hast eine PN
-
Hallo,
ich bin schon eine Zeit mit ioBroker unterwegs und habe auch ein Adapter den ich aufbaue und betreue.
Allgemein an alle die in dieses Projekt egal ob Core oder Adapter Zeit investieren -> EIN FETTES DANKESCHÖN!!!
Dokumentation ist ein wichtiges Thema das sehr gerne mal vernachlässigt wird. Deshalb würde ich gerne meinen Beitrag dazu leisten.
Es wird mangels Zeit vermutlich nicht allzu viel sein aber ich bemühe mich.
Github Username -> Der selbe wie hierMir ist noch aufgefallen das die Doku sehr versplittert ist (GitHub Wiki, ioBroker Website, ...) und das die einzige Möglichkeit auf die neue Doku zu kommen dieses Thema hier ist. Zumindest habe ich nix anderes gefunden
. Ist das derzeit noch so gewollt?Gruß
-
@dkleber89 sagte in [Aufruf] Helft bei der neuen ioBroker-Dokumentation und -Adapter-Referenz mit!:
Ist das derzeit noch so gewollt?
Ja!
Im Moment "gilt" noch die alte Doku.
Adapterreferenz ist dort leider nicht auf Admin V2.
Neuere Adapter noch nicht implementiert.Installation und Images sind immer aktuell
-
Ich spiele mit dem Gedanken zumindest für die Adapter die ich aktiv nutze an der neuen Doku mit zu schreiben - daher die Frage: welcher stand soll dokumentiert sein ?
Stable / Latest / github ?A.
-
@Asgothian
Latest wäre schon gut.@all Dokumentators:
es sollte noch in jedem Header neben dem Datum auch die dokumentierte Version genannt werden! -
Hey,
ich hab mich ja in letzter Zeit ausgiebig mit dem Discovery Adapter beschäftig und hab eh viel darin geändert und unnötiges entfernt.
Würde mich daher gern anbieten die Doku für den Discovery Adapter sowie die Entwicklung (wie bringe ich meinen Adapter in Discovery) zu machen. -
Link aus dem ersrten Beitrag funktioniert nicht, Fehler 404!
-
@x3l4 sagte in [Aufruf] Helft bei der neuen ioBroker-Dokumentation und -Adapter-Referenz mit!:
Link aus dem ersrten Beitrag funktioniert nicht, Fehler 404!
Siehe Announcements:
https://forum.iobroker.net/topic/22994/neue-dokumentation -
@Homoran auch auf https://www.iobroker.net kommt nur eine leere weiße Seite. Es ist sehr sehr mühsam sich alle benötigten Infos heran zu holen.
-
@x3l4 sagte in [Aufruf] Helft bei der neuen ioBroker-Dokumentation und -Adapter-Referenz mit!:
kommt nur eine leere weiße Seite.
bei mir klappt dein Link auf Anhieb. (mal forced reload gemacht?)
@x3l4 sagte in [Aufruf] Helft bei der neuen ioBroker-Dokumentation und -Adapter-Referenz mit!:
Es ist sehr sehr mühsam sich alle benötigten Infos heran zu holen.
Kannst du das genauer erklären?
-
Mir ist noch ein Fehler in der neuen Doku zur Übernahme der Adapterdoku aus github aufgefallen.
Euer Markdown-Interpreter interpretiert die Tabellen anders.
Bei github können die führenden und abschließenden senkrechten Striche bei einer Tabellenzeile fehlen.
vgl. auch https://help.github.com/en/articles/organizing-information-with-tables
"The pipes on either end of the table are optional."Bei euch leider nicht
Beispiel im Abschnitt Spieler
https://www.iobroker.net/#de/adapters/adapterref/iobroker.squeezeboxrpc/README.md
im Vergleich dazu im Abschnitt Player
https://github.com/oweitman/ioBroker.squeezeboxrpc/blob/master/README.md
