NEWS
Dokumentation zu ioBroker stark veraltet bzw. verteilt
-
Hallo zusammen,
zuallerst: Ich finde ioBroker die beste offene Zentralensoftware aktuell, und ich habe in den letzten paar Jahren jede namhafte ausprobiert ( FHEM -> openhab -> openhab +nodered -> homeassistant+nodered->iobroker sind alle irgendwan produktiv gewesen).
Aktuell entwickle ich auch einen Adapter. Den habe ich vor ein paar Tagen mal angefangen und baue ihn immer weiter aus.
Bin inzwischen sogar im LATEST repo angekommenJetzt wollte ich heute noch einen Adapter beginnen, finde aber die Anleitungen zum aufsetzen nicht mehr und verzweifle schon wieder.
Ich lande ständig auf Seiten, die gut anfangen, aber nicht zielführend sind, oder noch schlimmer auf Seiten die offiziell aussehen aber inzwischen obsolete sind.
Könnten wir das nicht mal gerade ziehen, denn es gibt bestimmt noch mehr Leute, die etwas zuliefern würden.
Und ich helfe gerne mit, die Dokumentation anzupassen, weiß aber nicht genug um das selbst zu beginnen.
wenn jemand sich auskennt und Lust hat wäre ich dabei.
grüße
E -
@EdgarM https://github.com/ioBroker/create-adapter
meinst du den?
-
@harrym said in Dokumentation zu ioBroker stark veraltet:
@EdgarM https://github.com/ioBroker/create-adapter
meinst du den?
unter anderem.
Ich denke, dass es ein Ort geben sollte, wo das grundsätzliche Aufsetzen der Eintwicklungsumgebung ( code,github,npmjs, test, deployment, latest, stable ) beschrieben werden sollte.
Für meinen ersten Adapter habe ich Tage gebraucht, die erste Version sauber zu testen weil ich vieles nicht verstanden hatte.
grüße
E -
@EdgarM sagte in Dokumentation zu ioBroker stark veraltet:
Ich lande ständig auf Seiten, die gut anfangen, aber nicht zielführend sind
wo hast du es denn versucht?
Aber ja, ich bin lange nicht mehr dazu gekommen die Doku zu erneuern/korrigieren.
bei fast 400 Adaptern ist das auch nicht so einfach.ABER
die jetzt 4. Doku (wahrscheinlich landest du immer im cache von alten Dokus) ist ein Repo auf github (https://github.com/ioBroker/ioBroker.docs).
da kann JEDER einen PR erstellen.zu erreichen unter https://www.iobroker.net/#de/documentation/
-
@EdgarM naja .... GIT musste dir schon selbst beibringen. Hat ja nur indirekt dann mit ioBroker zu tun .
-
@EdgarM sagte in Dokumentation zu ioBroker stark veraltet:
Für meinen ersten Adapter habe ich Tage gebraucht, die erste Version sauber zu testen weil ich vieles nicht verstanden hatte.
dann suchst du also eine Doku für Entwickler?
Ich glaube da gibt es irgendwo etwas.
Da ich aber nur ein kleiner Schreiberling bin, kann ich so etwas nicht erstellen. -
@harrym git kann ich
Aber ich habe es in den 3 Wochen z.b. nicht geschafft, die Releaseaction zu verstehen.
bin auch schon ein paar Jährchen in der IT ( bald mein halbes Leben ) und weiss wie Doku nervt
und ich bin ja ans Ziel gekommen.
grüße
-
@EdgarM na dann .. aber unter https://www.iobroker.net/#de/documentation/dev/adapterpublish.md ist doch alles schön beschrieben.
-
und bevor mich jemand falsch versteht, ich habe alles irgendwie gefunden und komme auch zurecht.
Ich vermute halt nur, dass es viele gibt die es nicht lange genug veruchen
-
@harrym said in Dokumentation zu ioBroker stark veraltet:
@EdgarM na dann .. aber unter https://www.iobroker.net/#de/documentation/dev/adapterpublish.md ist doch alles schön beschrieben.
gutes Beispiel, dort fehlt ( denke ich wenigstens ) Doku zu :
- widgets
- wie teste ich mein widget lokal
-> npm i /home/erdal/development/mat2/ioBroker.vis-material-advanced/iobroker.vis-material-advanced-0.5.5.tgz && iobroker upload vis-material-advanced
Das Release Script
...
Schon klar, dass das von der community kommen muss, deswegen biete ich auch an zu helfen.
grüße
E -
@EdgarM DU hast Recht - die Doku ist noch eine unserer Baustellen. AM Ende ist das hier https://forum.iobroker.net/topic/15195/aufruf-helft-bei-der-neuen-iobroker-dokumentation-und-adapter-referenz-mit immer noch hoch aktuell ...
Also: Du bist gern eingeladen selbst Inhalte (zB Dinge die Dir gefehlt haben und du dann gerfunden hast oder gelernt hast) als PRs hier einzuliefern https://github.com/ioBroker/ioBroker.docs/tree/master/docs/de . Es gibt da auch einiges an Dev Inhalten ... https://github.com/ioBroker/ioBroker.docs/tree/master/docs/de/dev ... sollte identisch auf der iobroker.net sein
-
@apollon77 said in Dokumentation zu ioBroker stark veraltet:
u dann gerfunde
mache ich sehr gerne. danke für die "offiziellen" Links
grüße
E -
und bevor ich es vergesse:
Der erste Link geht auf Forum. und der erste Link dort geht auf 404 - not found (https://iobroker.github.io/ioBroker.docs/).
Genau das meinte ich mit veraltet
-
@EdgarM sagte in Dokumentation zu ioBroker stark veraltet:
Ich vermute halt nur, dass es viele gibt die es nicht lange genug veruchen
ganz davon ab, dass es "so viele" Entwickler, die neu anfangen wohl nicht gibt, ist dafür ein Bereich auf der Website vorgesehen:
Die müsste dann aber bitte von einem (fortgeschrittenen) Entwickler angelegt werden.
Dann wäre auch die Entwicklerdoku auf unserer Website als zentrale Stelle
-
@Homoran said in Dokumentation zu ioBroker stark veraltet bzw. verteilt:
@EdgarM sagte in Dokumentation zu ioBroker stark veraltet:
Ich vermute halt nur, dass es viele gibt die es nicht lange genug veruchen
ganz davon ab, dass es "so viele" Entwickler, die neu anfangen wohl nicht gibt, ist dafür ein Bereich auf der Website vorgesehen:
Die küsste dann aber bitte von einem (fortgeschrittenen) Entwickler angelegt werden.
Dann wäre auch die Entwicklerdoku auf unserer Website als zentrale Stelle
Ja, die Seite habe ich eben ausgecheckt und würde da dann etwas zur entwicklung dazuschreiben was mir gefehlt hat.
Zum Doku-git hab ich gleich noch eine Frage.
Auf der ersten Seite ist bereits ein toter Link, man kann aber keine Issues aufmachen. Wem sag ic hda am besten Bescheid?
How to create the documentation See how to participate
ist 404, und ich wüßte auch nicht, wo das hinführen sollte.
grüße
E -
@EdgarM Kommando zurück, in meinem Fork gab es kein Issue Link, im Hauptrepo natürlich schon.
-
@EdgarM du kannst auch auf unserem Discord server vorbei schauen das ist meistens ein Entwickler online und kann dir Helfen. Dort kann man reden und Bildschirm teilen. -> https://discord.gg/HwUCwsH
Ich behaupte Aktuell Entwickelt sich noch immer alles sehr schnell und Chat ist die Beste Möglichkeit schnell ein zu steigen.
-
@EdgarM sagte in Dokumentation zu ioBroker stark veraltet bzw. verteilt:
Genau das meinte ich mit veralte
Ist es ja auch, das war der Entwurf der Seite von 2018, die mitllerweile unter iobroker.net schon lange online ist
-
@EdgarM sagte in Dokumentation zu ioBroker stark veraltet bzw. verteilt:
Schon klar, dass das von der community kommen muss, deswegen biete ich auch an zu helfen.
Hi, vielleicht magst du dich hieran beteiligen, startet voraussichtlich diesen Monat
-
@fastfoot Auf jeden Fall, sowas unterstütze ich sehr gerne.