Keine Doku oder Wikis nach der Installation?

haegar33

~~@haegar33:~~

was ist überhaupt das Konzept dieses Programms etc…? Dazu gibt es etwas auf [https://github.com/ioBroker/ioBroker](https://github.com/ioBroker/ioBroker).

Ja dieses Github Wiki ist einigermassen umfangreich, viele ander github projekte sind da ziemlich leer..

Auf iobroker.net finde ich immer noch nicht viel allerdings auf der verlinken website smarthomedevices.com stehen gute Texte.

Homoran

Nochmal die Frage was du genau suchst?

Ich muss zugeben, ich habe die Seite, die den Aufbau und die Struktur von ioBroker beschreibt auch nicht mehr auf Anhieb gefunden.

Aber irgendwo muss sie sein :lol:

Hilft vielleicht das?

http://www.iobroker.net/docu/?page_id=7322&lang=de

Gruß Rainer

Jan1

Das weiß er doch selber nicht, mault nur in seinen Beiträgen rum, dass es keine Dokus gibt, die er lesen könnte. Was erstens so nicht stimmt und die ihm wohl auch nichts bringen würden ;)

haegar33

Scheint sich ja in 2 Jahren nicht viel geändert zu haben:

https://www.iobroker.net/#de/documentation/install/README.md

"Dies ist ein Platzhalter" wirklich? Zu Installation? Stand 2018!!.
Ist IoBroker am Aussterben oder schaue ich an der falschen Stelle?

Homoran

@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?

haegar33

@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.

Homoran

@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.

Thomas Braun

@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.

haegar33

@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?

Homoran

@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

haegar33

@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?

Homoran

@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

Jey Cee

@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.

haegar33

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!

Homoran

@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!

Jey Cee

@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.

haegar33

@Homoran Sorry, beim Begriff DAU reagiere ich empfindlich, das ist eigentlich immer eine Beleidigung.

Homoran

@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

haegar33

@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?

Homoran

@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.

Community Forum

NEWS

Keine Doku oder Wikis nach der Installation?

Support us

469

32.9k

83.0k

1.3m