UPDATE 31.10.: Amazon Alexa - ioBroker Skill läuft aus ?

[Homoran]

@smarthome2020 Das ist dan schon kein Dokumentation-Adapter mehr, sondern eher ein troubleshooting-Adapter.
Aber auch keine schlechte Idee

[da_Woody]

@smarthome2020 sagte in Was macht ihr für den Fall, falls euch was passiert?:

Denn bis meine Dame

das wird immer da größte prob sein. jeder jammert wegen WAF, aber genau diese zumindest etwas ranzuführen...
wir machen sowas mit der prämisse, so funzt das.
meine vertraglich verbundene kann zumindest mit der shelly cloud halbwegs umgehn. hat aber auch genug interesse. will sich halt nicht wirklich damit beschäftigen, solange ich noch lebenszeichen von mir gebe. sie würde es sicher schaffen.
ohne interesse wirds auch eine gute doku, oder adapter nicht erledigen können.
just my 2€...

[hydrotec]

@homoran

Etwas brainstorming

Mir fällt dazu ein, in FHEM, ich weiß andere Baustelle, wurde folgendes umgesetzt.
In FHEM wird ja von Geräten gesprochen, ist in etwa mit den Adaptern in ioBroker vergleichbar.
(nicht wirklich, doch es erleichtert gerade die Erklärung)
Wenn man sich auf die Übersichtsseite eines Gerätes begibt, werden einem die Verbindungen/Verknüpfungen zu anderen Geräten aufgezeigt, mit denen es sich in Abhängigkeit befindet.
Gut, FHEM ist ein in sich geschloßenes System, und wenn ich es richtig verstanden habe, werden die Adapter in ioBroker jeder für sich als eigener Prozess gestartet.
Deswegen bin ich mir nicht sicher, ob das so überhaupt umsetzbar wäre.
Ich fand es jedenfalls eine große Erleichterung, mich durch den Gerätedschungel zu kämpfen,
vor allem welche Automatik mit dem Gerät verbunden ist, oder auch auf eine weitere Automatik zugreift.

[da_Woody]

@hydrotec schön und gut, nutzt aber deinem eheweib/freundin nichts, wenn sie keine ahnung von dem zeug hat...
und ihr das eigentlich sch.....egal ist.
sind wir wieder beim WAF. den gibts für mich nicht. entweder, sie macht mit, oder ich kann das nicht umsetzen.
WAF ist für mich, daß sie immer noch einen ausweg hat.

[David G.]

Ich finde das darf nicht zu kompliziert werden.

Infos in die Datenpunkte schreiben finde ich nicht so Sinnig. Wie oft liest mann "Butta die Datenpunkte vom Adapter löschen und diese neustarten".

Was ich praktisch finden würde:

• Sich die relevanten Datenpunkte manuell in Doku Adapter hinzuzufügen.
• Dann kann man diese zb ähnlich wie hier im Forum mit einem @xxxxx in seine Beschreibung einbinden.
• Den hinzugefügten Datenpunkten Verknüpfungen untereinander zuweisen können.
• Eine Übersicht mit allen angelegten Datenpunkten. Wenn der verknüpfte Datenpunkt gelöscht wurde erscheint er in rot oder einen Ausrufezeichen etc. Dann sieht man wo man seine Doku nachbessern muss.
• Man kann den Datenpunkten Infos in Textform (auch mit dem besagten @xxxxx) hinzufügen.
  -Alle Infos werden vom Adapter gespeichert

EDIT:

• Es wäre cool, seine Dokus ähnlich wie die Skripte im Javascript Adapter in einer Ordnerstrucktur sortieren zu können
• Die Datenpunkte analog zur Struktur unter den Objekten.
• Die besagten roten Hinweise sollten aicu in den Dokus sichtbar sein
• Suche von Dokus mit den besagten (roten) fehlerhaften Datenpunkten.

[hydrotec]

@da_woody

wollte nur etwas konstruktives zu den Adaptern sagen, welche hier schon im Thread angesprochen wurden.
Mehr nicht.
Zu dem eigentlichen Thema hatte ich ja schon etwas geschrieben.

[David G.]

Wäre es evtl sinnig, die Adapterdiskussion in ein eigenen Topic zu verschieben?

[Homoran]

@smarthome2020 sagte in Was macht ihr für den Fall, falls euch was passiert?:

dann ist man an dem Punkt, dass ein Ausfall des Aufsetzers wahrscheinlich zu einem Problem zu Hause führt.

und damit sind wir endlich wieder beim Thema dieses Threads und da bleiben wir jetzt auch

[dirkhe]

Was haltet ihr denn von folgender Idee:
In den allgemeinen ioBroker settings kann man eine Url mit Platzhaltern hinterlegen, zb:

http://localhost/meineDoku/<adapter-name>?device=<device>&channel=<channel>&name=<name>&id=<id>#name

Im admin selber wird (sobald diese Url gepflegt ist) dann ein infoIcon eingeblendet. Immer wenn der User dann darauf klickt, wird ein popup aufgerufen oder ein neuer tab mit immer gleichen Namen. Die Parameter könnte man dann beim Klick erst berechnen, denn das kann man ja per context des click-targets errechnen. Dann kostet das fast keine Performance und der Benutzer kann dann seine Doku entsprechend hinterlegen. Wenn nicht gepflegt, wird halt auch nichts angezeigt. Er kann dann selber entscheiden, ob er ein eigenes wiki oder eine selbst gebaute Applikation nimmt oder was auch immer.

Man könnte dann auch immer noch einen Adapter entwickeln, der dann seine eigene Url dort einträgt und der bei der Doku an sich unterstützt.

Als Default-Url könnte man auch eine interne Seite anzeigen, indem man die Funktionalität erklärt und auch sagt, wer das Icon nicht haben will, einfach die Url zu löschen hat. So kann man da automatisch auch mit werben.

[OliverIO]

@homoran

• allgemeine dokufelder je adapter, datenobjekte, sonstiges vorsehen
• exportfunktionalität nach html/PDF (auch regelmäßig automatisierbar)
• callback für die adapter, damit ein adapter optional seine sub-doku ebenfalls mit an iobroker zur Ausgabe übergeben kann. ich denke da an Datenstrukturen, die in der adapter-Konfiguration eingegeben werden und darüber ordentlich ausgegeben werden können, ohne das iobroker darüber Details kennen muss. Umsetzen kann das dann jeder adapter-owner (oder auch nicht)

[Homoran]

@oliverio ich hatte das was gesehen, dass es ein common.comment o.ä. in den Objekten zu jeder id geben soll

[OliverIO]

@homoran
ja aber nicht nur datenobjekte, auch noch zu jedem adapter, welches frei befüllt werden kann.
und dann noch eine möglichkeit, das der adapter selbst seine innere struktur, welche nicht in datenobjekte abgelegt ist in text ausgeben kann. bspw der node-red könnte seine flows ausgeben und dort wieder erklären für was die flows sind (comment nodes).
da das was adapter spezifisches ist, kann iobroker nur jeden adapter fragen (callback) ob er diese informationen hat.

[Thisoft]

Wisst ihr - mal ganz ehrlich seh ich nicht so richtig ein warum ich einen reisen Aufwand an Doku etc. treiben soll um letztendlich jemanden - und sei es Frau oder Kind - wider seinen Willen oder Interesse an meine Technik heranzuzwingen. Wenn sie sich jetzt nicht weiter für Haus und Hof interessieren - auch gut - dann fallen sie halt ins kalte Wasser wenn es wirklich mal soweit sein sollte :-( Sie hätten ja über Jahre (-zehnte) hinweg die Gelegenheit gehabt sich mit einzuarbeiten. Wenn nicht dann eben nicht:man-shrugging: Meine Frau schreibt schließlich auch keine Doku wie ich ein Steak braten oder Spaghetti kochen oder Wäsche waschen muss. Wenn sie mal nicht mehr da ist bekomm ich's entweder selber auf die Reihe oder ich muss mich eben kümmern irgendwoher Hilfe zu bekommen oder ich esse nur was im Garten wächst ;-) Klingt jetzt vielleicht hart, ist aber ganz einfach pragmatische Realität - finde ich jedenfalls. Zu guter Letzt hätte ich mich sonst mit Doku etc. rumgequält und im Ernstfall ist das Einzige was ihr dazu einfällt dass Sie jemanden holt der den ganzen Sch..dreck einfach rausreißt und zurückbaut - ist dann auch gut wenn ich nicht mehr da bin - könnte sie machen wie sie will...

[OliverIO]

@thisoft
aber die Möglichkeit zu haben wäre schon gut.
Wenn du es dann nicht nutzt, auch gut.