Keine Doku oder Wikis nach der Installation?
-
@haegar33 sagte in Keine Doku oder Wikis nach der Installation?:
Ist IoBroker am Aussterben
wahrscheinlich!
sind nur noch 50.000 User übrig.aber das hier nur eeine "platte" allgemeingehaltene EINLEITUNG(=introduction) hinsollte ist dir schon klar?
Und in die Unterpunkte manuell-Installation... hast du auch mal gesehen? -
@Homoran Ja habe ich natürlich gelesen. Aber was sollen solche leeren Einleitungsseiten die seit 2 Jahren nicht gefüllt werden?
Vermutlich hättet ihr schon 100.000 User wenn die Doku nicht so schlecht wäre. Wird auch in vielen YouTube Videos kritisiert. Dort findet man auch glücklicherweise viele ehrgeizige YouTuber mit Erklärvideos. -
@haegar33 Jetzt mal etwas weniger polemisch, bitte!
Das ist ein Open Source Projekt und du kannst gerne die Dokus per pull request für die leeren Seiten liefern.
Dass die Menüpunkte leer sind liegt daran, dass die Menüstruktur als erstes erstell werden musste und dann natürlich die wichtigen Seiten zu erst gefüllt wurden und keine reinen "füllinhalte" wie "Einleitung".
Was die Youtuber angeht wirst du wesentlich mehr veraltete, lieblose und sogar falsche Videos finden als die wenigen guten.
Leider haben wir im Forum ausreichend damit zu tun die daraus resultierenden Fehler zu korrigieren, dass wir gar nicht mehr dazu kommen an der Doku zu arbeiten.
-
@haegar33
Das schöne bei OpenSource-Projekten ist:
Es kann/darf/soll da jeder mitmachen, der ein Problem erkannt hat.
Sei es ein Beitrag per Code, per Dokumentation oder per fundierter Fehlermeldung.
Wo ist dein Beitrag? In zwei Jahren hast du ja bestimmt das ein oder andere an Erfahrung sammeln können, das du jetzt in Forum eines wunderbar ausgereiften, aktuellen Dokumentation weitergeben kannst. -
@Homoran Als github user kann ich wohl in die docs editieren? Vielleicht mache ich das auch noch schon aus ganz egoistischen Gründen
Gerade wenn ein Projekt so lebendig ist sollte man die Doc so aktuell wie möglich halten! Die Alternative ist dann nur endlose Diskussionen und Wiederholungen im Forum. Kennt man ja von anderen Projekten auch oder? Was ist mehr Arbeit?
-
@haegar33 sagte in Keine Doku oder Wikis nach der Installation?:
Vielleicht mache ich das auch noch
Wäre schön.
@haegar33 sagte in Keine Doku oder Wikis nach der Installation?:
Die Alternative ist dann nur endlose Diskussionen und Wiederholungen im Forum.
Das wird sich auch mit einer umfangreichen Doku nicht wirklich ändern.
@haegar33 sagte in Keine Doku oder Wikis nach der Installation?:
Was ist mehr Arbeit?
Das ist der falsche Ansatz!
Wie gesagt wird die Arbeit im Forum sicher bleiben.Aber das muss man positiv sehen:
Man erkennt wo die User die Probleme wirklich haben und kann das (wenn die Zeit es dann erlauben würde) in die Doku einfließen lassen.Für mich ist eine Doku, die nur aus der Theorie entstanden ist sowieso nicht brauchbar. Höchstens um etwas zu haben, was man dann im Forum verlinken kann.
Da aber dein Anspruch ist, das Vorgehen nach der Installation allgemeingültig für 400 Adapter und alle damit verbundenen Permutation für jeden Einsteiger verständlich zu erstellen bin ich jetzt wirklich gespannt
-
@Homoran said in Keine Doku oder Wikis nach der Installation?:
@haegar33 sagte in Keine Doku oder Wikis nach der Installation?:
Die Alternative ist dann nur endlose Diskussionen und Wiederholungen im Forum.
Das wird sich auch mit einer umfangreichen Doku nicht wirklich ändern.
Meine Erfahrung ist anders. Aber sei's drum...
Für mich ist eine Doku, die nur aus der Theorie entstanden ist sowieso nicht brauchbar.
Ähm, wer schreibt den eine Doku zu einem Smarthome System ohne praktische Erfahrung??
Da aber dein Anspruch ist, das Vorgehen nach der Installation allgemeingültig für 400 Adapter und alle damit verbundenen Permutation für jeden Einsteiger verständlich zu erstellen bin ich jetzt wirklich gespannt
Das ist natürlich Aufgabe der Adapter Programmierer und die scheinen auf ihren Github Seiten sehr unterschiedlichen Fleiss zu haben. Vielleicht sollte man wie z.b. bei HomeAssistant ein "offizielles" Repository einrichten wo nur Adapter reinkommen die auch einen Mindestandard bei der Dokumentation erfüllen? Alles andere ist dann freie GitHub SW die man "freiwillig" dazu laden kann?
-
@haegar33 sagte in Keine Doku oder Wikis nach der Installation?:
Das ist natürlich Aufgabe der Adapter Programmierer
Das sehe ich anders - oder hier liegt ein Missverständnis vor.
Ich rede nicht von einer "technical docu" - die sollte sich im Adapterrepo finden, sondern von einer Doku für Ensteiger, Anfänger, Noobs und DAUs -
@haegar33 sagte in Keine Doku oder Wikis nach der Installation?:
Das ist natürlich Aufgabe der Adapter Programmierer
Gewagte Aussage, zum ersten sind auch die Adapter open source und jeder kann sich beteiligen. Und zum zweiten weis ich selbst als Programmierer nicht alles was möglich ist oder wie manche sachen funktionieren. Dazu müsste man ja die gesamte Hardware kennen die am anderen Ende sein kann, was gerade bei Standards wie Zigbee, Zwave oder EnOcean unmöglich ist.
-
Ich spreche auch nicht von technischen Details sondern ganz einfachen Infos:
- welche Objekte erzeugt der Adapter?
- was bedeuten sie?
- gibt es eine passende Vis dazu?
- usw...
Das gibt es vereinzelt, manchmal ist es auch selbserklärend aber zu oft null info zur Anwendung.
Übrigens ist genau das was ein Einsteiger braucht, ioBroker selber installieren ist ja relativ einfach und die GUI hat man schnell im Griff.PS: Es gibt keine DAUs nur DAPs... die dümmsten anzunehmenden Programmierer!
-
@haegar33
Ich hatte dich eben schon gebeten deine Ausdrucksweise zu mäßigen!
Ich hatte wohl den falschen Eindruck du hättest es verstanden.Bitte halte dich in Zukunft an eine gepflegtere Ausdrucksweise!
-
@haegar33 sagte in Keine Doku oder Wikis nach der Installation?:
welche Objekte erzeugt der Adapter?
was bedeuten sie?
gibt es eine passende Vis dazu?
usw...Und genau das ist eben nich einfach möglich. Es gibt ne Menge Adapter die erzeugen die Objekte anhand der Daten die sie erhalten, aber selbst da wo sie fest definiert sind muss der Entwickler nicht zwingend wissen wofür sie genau sind oder was sie bewirken, was dann auch wieder vom Gerät abhängig sein kann.
Du solltest selbst mal einen Adapter Entwickeln, selbst wenn du das nur Theoretisch machst. Dann bekommst du einen Eindruck davon wie Schwierig es ist das was du forderst um zu setzen. -
@Homoran Sorry, beim Begriff DAU reagiere ich empfindlich, das ist eigentlich immer eine Beleidigung.
-
@haegar33 sagte in Keine Doku oder Wikis nach der Installation?:
das ist eigentlich immer eine Beleidigung.
Nö!
Das ist eine Bezeichnung, die sich die User selber geben -
@Jey-Cee said in Keine Doku oder Wikis nach der Installation?:
Und genau das ist eben nich einfach möglich. Es gibt ne Menge Adapter die erzeugen die Objekte anhand der Daten die sie erhalten, aber selbst da wo sie fest definiert sind muss der Entwickler nicht zwingend wissen wofür sie genau sind ...
Wirklich? Wozu ist ein Adapter dann gut wenn man nicht weiss was die Parameter und Objekte bedeuten? Welchen Sinn hat das?
-
@haegar33 sagte in Keine Doku oder Wikis nach der Installation?:
@Jey-Cee said in Keine Doku oder Wikis nach der Installation?:
Und genau das ist eben nich einfach möglich. Es gibt ne Menge Adapter die erzeugen die Objekte anhand der Daten die sie erhalten, aber selbst da wo sie fest definiert sind muss der Entwickler nicht zwingend wissen wofür sie genau sind ...
Wirklich? Wozu ist ein Adapter dann gut wenn man nicht weiss was die Parameter und Objekte bedeuten? Welchen Sinn hat das?
Ich glaube du hast das Prinzip nicht verstanden.
Es gibt eine (oder mehrere) Handvoll Programmierer und tausende User.
letztere haben einen Wunsch, dass etwas eingebunden werden soll.
Aber leider nicht die Fähigkeit das zu tun.
Dafür wissen sie genau was und warum sie es wollen.Das übernimmt dann ein Entwickler, der wiederum nicht unbedingt weiß was und wofür er das macht.
Er sorgt "lediglich" dafür, dass die User an die Daten kommen - wofür ist ihm (möglicherweise) egal.Und genau darum ist es wichtig, dass die Doku nicht vom Entwickler kommt.
-
@haegar33 sagte in Keine Doku oder Wikis nach der Installation?:
Wirklich? Wozu ist ein Adapter dann gut wenn man nicht weiss was die Parameter und Objekte bedeuten? Welchen Sinn hat das?
Ein kleines Beispiel:
Nimm z.B. den Unifi Adapter. Dieser Adapter bekommt alle möglichen Daten per API rein, je nach dem welche Hardware ein Nutzer hat. Glaubst Du ein Adapter Entwickler hat die komplette Hardware zu Hause und kann testen was alles geht ? -
@Homoran said in [Keine Doku oder Wikis nach der Installation?]> letztere haben einen Wunsch, dass etwas eingebunden werden soll.
Aber leider nicht die Fähigkeit das zu tun.
Dafür wissen sie genau was und warum sie es wollen.Das übernimmt dann ein Entwickler, der wiederum nicht unbedingt weiß was und wofür er das macht.
Er sorgt "lediglich" dafür, dass die User an die Daten kommen - wofür ist ihm (möglicherweise) egal.Ok, wenn man dieses Prinzip verfolgt kann man es verstehen. ioBroker wird dann quasi als Breadboard betrachtet wo durch einen Adapter "plötzlich" neue Objekte auftauchen und der User soll dann experimentieren und sicher selber was zusammen basteln. Zumindest das sollte dann sinngemäß in der Doku stehen
Ist schon ziemlich anders als bei HomeAssistant, openHAB usw.. -
Würde vorschlagen die "Leichen" in der Doku als Headlines ganz zu löschen. Wenn z.b. niemand Lust hat etwas über "Erweiterte Konfiguration" zu schreiben braucht man auch keine Platzhalter? Ca. 70% aller Kapitel sind leer.
-
@haegar33 sagte in Keine Doku oder Wikis nach der Installation?:
Würde vorschlagen die "Leichen" in der Doku als Headlines ganz zu löschen
Ich sagte schon, dss das nicht geht ohne die ganze Programmstruktur der Doku zu zerstören
