Was fehlt um das ioBroker Grundprinzip zu verstehen?
-
@crunchip sagte in Das ioBroker Grundprinzip verstehen:
edoch habe ich bei manchen Adaptern so meine Schwierigkeiten, was der oder jene Eintrag in der Instanz bewirkt und ne Dokumentation bezüglich habe ich auch nicht gefunden.
Das meine ich doch.
Die Doku, die ich damals gemacht habe, hatten zu jeder Einstellung eine Erklärung. (vielleicht kennst du diese noch - tauchen immer mal wieder hier als uralter Link im Forum auf)
Hier ein "aktuelles" Beispiel: https://www.iobroker.net/#de/adapters/adapterref/iobroker.admin/README.mdDas war eine Heidenarbeit, alleine mit allen Screenshots dazu.
Ich bin nachher nicht mehr mit "auf dem Stand halten" nachgekommen. bei 20-50 Adaptern ging es noch, aber bei 400+ no chance!
Und so werden die technischen Infos aus den Adapter repos jetzt als Doku genutzt
-
@homoran sagte in Das ioBroker Grundprinzip verstehen:
vielleicht kennst du diese noch
Natürlich und ist auch logisch das man da nicht hinterher kommt.
@homoran sagte in Das ioBroker Grundprinzip verstehen:
Ich bin nachher nicht mehr mit "auf dem Stand halten" nachgekommen
Ist und sollte auch nicht die Aufgabe eines einzelnen sein.
@homoran sagte in Das ioBroker Grundprinzip verstehen:
Und so werden die technischen Infos aus den Adapter repos jetzt als Doku genutzt
Und da liegen auch Welten dazwischen, die einen ausführlichst und andere wiederum eher dürftig.
Wenn ich mich bei den Adaptern durch klicke, verläuft das bei vielen ins leere und hilft nur Seite neu laden.
https://www.iobroker.net/#de/adapters -
@crunchip sagte in Das ioBroker Grundprinzip verstehen:
Wenn ich mich bei den Adaptern durch klicke
da greift jetzt langsam die Idee, des "neuen" Frameworks.
Die dort hinterlegten Infos sollten die selben sein, die du über das Fragezeichen in der Adapterkachel erhältst.
Die (wirklich gute) Idee dahinter ist, dass nur noch die Doku im Adapterrepo gepfelgt werden muss, und alles andere daraus gespeist wird.
Dann kann jeder einen pullrequest mit Änderungen beim Adapter erstellen und "sofort" ist die Doku aktuellIm Prinzip das immer wieder geforderte WIKI
Leider ist die notwendige Struktur (mehrsprachig) noch lange nicht bei allen Adaptern implementiert.
-
Ja Doku ist eine Großbaustelle und leider arbeitet da gerade keiner aktiv dran. Woran gerade gearbeitet wird ist es die Development Doku rauszulösen weil wir hier andere Strukturen brauchen. Das Grundkonzeption der restlichen Doku und der Aufbau ist denke immer noch sinnvoll und kann ich bei Interesse gern nochmal zum besten geben in nem geeigneten Rahmen. Was fehlt ist der Content der das mit leben füllt.
Auch hier gern wieder der Aufruf: wer an Doku mitmachen will bitte melden!! ;-))
-
@apollon77 sagte in Das ioBroker Grundprinzip verstehen:
Ja Doku ist eine Großbaustelle und leider arbeitet da gerade keiner aktiv dran. Woran gerade gearbeitet wird ist es die Development Doku rauszulösen weil wir hier andere Strukturen brauchen. Das Grundkonzeption der restlichen Doku und der Aufbau ist denke immer noch sinnvoll und kann ich bei Interesse gern nochmal zum besten geben in nem geeigneten Rahmen. Was fehlt ist der Content der das mit leben füllt.
Auch hier gern wieder der Aufruf: wer an Doku mitmachen will bitte melden!! ;-))Wenn das erstellen der Doku rein auf content fokusiert, werden sicher viele mitmachen und ihr Wissen, was hier im Forum zum besten gegeben wird, auch in einer Doku mit ergänzen.
apropos: kann man in der adapter doku mit einem Kennzeichen rechnen, welche die nicht zu übersetzende Teile markiert?
In meiner Doku werden Anteile (Schlüsselbezeichnungen) übersetzt die nicht sinnvoll sind zu übersetzen. -
@oliverio sagte in Das ioBroker Grundprinzip verstehen:
kann man in der adapter doku mit einem Kennzeichen rechnen, welche die nicht zu übersetzende Teile markiert?
Wenn sich da nichts geändert hat reicht es diese Begriffe in einfache Anführungszeichen zu setzen.
aber die echten
so wie 'hier', nicht diese -
@apollon77 sagte in Das ioBroker Grundprinzip verstehen:
Was fehlt ist der Content der das mit leben füllt.
ich fürchte das ist nicht alles
ich bin mir nicht sicher ob ich schon zu jedem Thema schon Menüpunkte angelegt und mit entsprechenden leeren Seiten verknüpft habe. -
(mein erster Post hier, bin etwas traurig wenn ich mir diesen Thread so anschaue!)
Ich bin hier gelandet weil ich mir etwas Verständnis über die Grundstruktur von IoB erhofft habe.
Ich versuche seit ca. 3 Wochen mir eine Strategie für den Einsatz des IoB zurechtzulegen und habe Stunden mit dem zusammensuchen von Grundlageninfo verbracht.
Was ich gefunden habe war meist veraltet (spricht für die Dynamik des System durch hyperaktive Adapterwentwickler die leider meist die Zeit nicht finden mit einem Zehnzeiler im Header in GitHub den Sinn und die Funktion des Adapters zu erklären, möglichst ohne Abkürzungen die dem Anfänger meistens nicht geläufig sind).
Die Struktur der Doku sieht eigentlich gut aus, aber leider lande ich meistens bei leeren oder nicht mehr gültigen Seiten.
Ich würde ja gerne bei der Doku mithelfen aber dazu müsste ich die Grundprinzipien verstehen. Dies klappt aus Doku und verfledderten Forumsbeiträgen mit Anfeindungen und 0 Gehalt zum Threadtitel (damit meine ich nicht appollon77 !!) nicht in der zur Verfügung stehenden Zeit.
Aus meiner Sicht würde es Sinn machen wenn jemand ziemlich oben in der Dokumentenstruktur auf 2 Seiten das Funktionsprinzip von IoB grafisch mit Klötzchen und Pfeilen (Informationsfluss) darstellen können. Auch Middleware folgt einem Eingabe Verarbeitungs Ausgabe Prinzip welches sich mit Klötzen und Pfeilen für einen Anfänger viel verständliche darstellen lässt.
Die meisten Adapter stellen I, O oder Kombination von IO für ein bestimmtes Gerät/IoT Objekt dar.
Dann gibt es aber noch Adapter mit einer zentralen Funktion dazwischen und diese sind für den Anfänger nicht zu finden oder zu verstehen weil er noch gar nicht versteht was es gibt und was er braucht. Diese Erkenntnis scheint den meisten fortgeschrittenen hier ziemlich abzugehen wenn ich die arroganten Anfeindungen bei gewissen Anfängerfragen so lese (scheint in deutschsprachigen Foren spätestens seit Corona leider standard zu sein).
Statt Haarspaltereien von Details in Forumsbeiträgen würden hier einige Ihre Zeit besser in für Anfänger verständliche Dok investieren.
just my 5 cents -
@heiri56 sagte in Das ioBroker Grundprinzip verstehen:
Ich würde ja gerne bei der Doku mithelfen aber dazu müsste ich die Grundprinzipien verstehen. Dies klappt aus Doku und verfledderten Forumsbeiträgen mit Anfeindungen und 0 Gehalt zum Threadtitel
Diese Formulierung ist aber auch nicht unbedingt geeignet etwas zu verbessern.
Aber gut, dass du vorbeisiehst.
Wir sind gerade dabei einen neuen Anlauf zu machen.
Dieser Thread sollte schon seit ein paar Tagen aufgeräumt werden, da das Bild wirklich nicht gut ist, aber die Zeit eines Neben"beruflichen" Dokumentators /Forenadmin/Moderators und Notnagel für Hilfesuchende ist ebenfalls sehr begrenzt.@heiri56 sagte in Das ioBroker Grundprinzip verstehen:
Aus meiner Sicht würde es Sinn machen wenn jemand ziemlich oben in der Dokumentenstruktur auf 2 Seiten das Funktionsprinzip von IoB grafisch mit Klötzchen und Pfeilen (Informationsfluss) darstellen können.
Damit habe ich so meine Probleme.
Ich behaupte mal - so geht das nämlich gar nicht, da dann die Pfeile zu 400 Klötzchen "etwas" unübersichtlich werden.
Spätestens wenn Alexa, Google Home, oder nur Drittanbieter Apps noch funktional "dazwischenfunken".Jetzt muss ich mir deinen Beitrag noch mindestens 5mal durchlesen, bis ich (betriebsblind wie ich bin
) nachvollziehen kann was du erwartest.Bitte nicht falsch verstehen - wir brauchen genau dieses Feedback!!
Dafür habe ich ja gestern das neue Unterforum für Einsteiger - und darin das Subforum Anregungen - Verbesserungsvorschläge eingerichtet.
https://forum.iobroker.net/topic/51543/neues-unterforum-nur-für-einsteigerfragen
Da habe ich schon einiges von deinem Post vorweggenommenLeider bin ich nicht mehr dazu gekommen diesen Thread hier sinnvoll zu zerlegen, dorthin zu verfrachten und dabei von o-Aussagen zu säubern
-
@heiri56 sagte in Das ioBroker Grundprinzip verstehen:
Aus meiner Sicht würde es Sinn machen wenn jemand ziemlich oben in der Dokumentenstruktur auf 2 Seiten das Funktionsprinzip von IoB grafisch mit Klötzchen und Pfeilen (Informationsfluss) darstellen können
https://github.com/ioBroker/ioBroker/raw/master/img/architecture.png
ansonsten steht doch erstmal auf der Willkommen und Grundlagen erste Informationen, desweiteren ist der Aufbau unter Admin Oberfläche beschrieben.
@heiri56 sagte in Das ioBroker Grundprinzip verstehen:
Ich versuche seit ca. 3 Wochen mir eine Strategie für den Einsatz des IoB zurechtzulegen und habe Stunden mit dem zusammensuchen von Grundlageninfo verbracht.
oder einfach direkt fragen, geht meist schneller
-
Danke für Deine Antwort.
Das neue Unterforum habe ich gesehen, war aber als ich vorbeikam mit 1 Beitrag ziemlich leer, wird ja vielleicht mal.
Ich persönlich würde das in der Dokstruktur besser finden.
Die Problematik so was in einem Forum zu lösen wird genau in diesem Thread leider sehr offensichtlich.
Den Zeitaufwand die für Aufräumarbeiten von Admins für die Ergüsse gelangweilter Forumsteilnehmer finde ich zum ko....
Deine sicher wertvolle Zeit und Wissen könnte hier sicher besser eingebracht werden als mit aufräumen verschletzt zu werden. -
@crunchip sagte in Das ioBroker Grundprinzip verstehen:
https://github.com/ioBroker/ioBroker/raw/master/img/architecture.png
ich glaube nicht, dass es das ist, was @heiri56 meint.
eher so:
(mal eben schnell hingepinselt - nur als Diskussionsgrundlage)Nehme ich an!!
-
@heiri56 sagte in Das ioBroker Grundprinzip verstehen:
war aber als ich vorbeikam mit 1 Beitrag ziemlich leer, wird ja vielleicht mal.
wenn du da nichts reinschreibst wird es nie mehr
Den Rest muss ich dir leider widersprechen:
@heiri56 sagte in Das ioBroker Grundprinzip verstehen:
Den Zeitaufwand die für Aufräumarbeiten von Admins für die Ergüsse gelangweilter Forumsteilnehmer finde ich zum ko....
das ist hier ein gaaaanz seltener Extremfall
Aufräumen habe ich in den letzten 8 Jahren vielleicht dreimal müssenaber:
anstelle an der Struktur der Doku zu arbeiten ist ein direkter Kontakt zu den Usern aus verschiedenen Gründen sinnvoll(er):
mit individueller Hilfe ist ein User schneller zufriedengestellt
(ja, es gibt auch Fallstricke)
Durch den direkten Kontakt und Rückfragen kann men erkennen wo noch Defizite sind.Und genau deswegen habe ich diesen "Meckerthread" nicht aufgeräumt, weil wir hier Infos sammeln möchten
Aber ja, die Zeit ist endlich
-
@homoran Ja aber genau DAS ist ja bei jedem anders
-
@apollon77 sagte in Das ioBroker Grundprinzip verstehen:
@homoran Ja aber genau DAS ist ja bei jedem anders
Könntest du das DAS bitte spezifizieren.
DAS versteht nämlich auch jeder anders
-
@homoran sagte in Das ioBroker Grundprinzip verstehen:
verschiedenen Gründen sinnvoll(er):
Viel Wissen "entsteht" auch hier im Forum, eben durch den Austausch.
-
@homoran Ok "DAS" ist ds jemand iobroker hat und über Gateways mit Geräten spricht
-
@crunchip und alle anderen, Ihr antwortet schneller als antworten kann
Ich habe mich lange durch Willkommen und Grundlagen gewühlt und bin dann meistens erwartungsvoll einem Link ins Nirwana oder in die Büchse der Pandorra gelangt. (ich bin nicht lesefaul, im Gegenteil).
Ich lese auch lieber ein einigermassen strukturiertes Dokument als die Zeit mit einem Instruktionsvideo zu verplempern wo einer radebrechend sich selbst darstellt, am liebsten in einer Fremdsprache die er nicht beherrscht.Die direkte Ansprache eines User mag zwar mein aktuelles Problem lösen (falls nicht ein gelangweilter Besserwisser dazwischengrätscht), wir aber später in den Forumstiefen schlecht gefunden und ist damit mehr verpuffte Zeit auf beiden Seiten (meine Sicht, ich weiss das ich "old fashioned" gestrickt bin) aber immerhin fundieren die aktuellen schnellschüsse auf Technologien die nur dank der Basisarbeit meiner Generation überhaupt möglich sind.
-
@jey-cee sagte in Das ioBroker Grundprinzip verstehen:
@homoran sagte in Das ioBroker Grundprinzip verstehen:
verschiedenen Gründen sinnvoll(er):
Viel Wissen "entsteht" auch hier im Forum, eben durch den Austausch.
Das ist auch der Grund, warum ich das als oberste Priorität meiner Zeitressourcen habe
Aber wir müssen es endlich mal strukturieren.Die alten Anleitungen (die ich noch als Dateien besitze) passen anscheinend heute nicht mehr für das Klientel der ioBroker Nutzer.
Damals wurde tatsächlich hauptsächlich bestehendes eingebunden, inzwischen starten viele neue User ihr Smarthome direkt mit ioBroker, ohne sich bewusst zu sein, dass es "nur" eine Middleware ist
Außerdem wird inzwischen vieles gemacht "weil es geht".
Und nicht zuletzt ist die Bastlerfraktion deutlich größer geworden -
@heiri56 sagte in Das ioBroker Grundprinzip verstehen:
Ich habe mich lange durch Willkommen und Grundlagen gewühlt und bin dann meistens erwartungsvoll einem Link ins Nirwana oder in die Büchse der Pandorra gelangt. (ich bin nicht lesefaul, im Gegenteil).
Ja - das ist eine Baustelle.
Dieser THread war gerade die Tage wieder ein erneuter (notwendiger) Anstoß dieses Loch zu flicken@heiri56 sagte in Das ioBroker Grundprinzip verstehen:
Ich lese auch lieber ein einigermassen strukturiertes Dokument als die Zeit mit einem Instruktionsvideo zu verplempern
Willkommen im Club.
Aber da gehörst du zu einem immer kleiner werdenden Anteil der USer@heiri56 sagte in Das ioBroker Grundprinzip verstehen:
Die direkte Ansprache eines User mag zwar mein aktuelles Problem lösen (f
alls nicht ein gelangweilter Besserwisser dazwischengrätscht), wir aber später in den Forumstiefen schlecht gefunden und ist damit mehr verpuffte Zeit auf beiden SeitenNein, das siehst du zu eng.
Diese dann gesammelten Informationen können- in anderen ähnlichen Threads verlinkt werden
- über die Suche gefunden werden (hoffentlich, die Suche klappte schon mal besser)
- bei wirklich wichtigen/guten Inhalten angepinnt werden
- dazu beitragen die Doku inhaltlich besser an den Bedarf anzupassen
