<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title><![CDATA[Dokumentations-Support]]></title><description><![CDATA[Themen zur Erstellung der offiziellen Dokumentation]]></description><link>https://forum.iobroker.net/category/186</link><generator>RSS for Node</generator><lastBuildDate>Fri, 10 Apr 2026 19:52:09 GMT</lastBuildDate><atom:link href="https://forum.iobroker.net/category/186.rss" rel="self" type="application/rss+xml"/><pubDate>Thu, 09 Oct 2025 15:20:30 GMT</pubDate><ttl>60</ttl><item><title><![CDATA[telegram-meue Menüstruktur HILFE]]></title><description><![CDATA[@aphofis bitte den Threadtitel aussagekräftig und verständlich gestalten
]]></description><link>https://forum.iobroker.net/topic/82456/telegram-meue-menüstruktur-hilfe</link><guid isPermaLink="true">https://forum.iobroker.net/topic/82456/telegram-meue-menüstruktur-hilfe</guid><dc:creator><![CDATA[Homoran]]></dc:creator><pubDate>Thu, 09 Oct 2025 15:20:30 GMT</pubDate></item><item><title><![CDATA[Vorschlag: RAG System für die Doku]]></title><description><![CDATA[@bloop so ein ähnliches Projekt mach ich auch gerade: https://github.com/Holger-Will/ioBroker.kiwi
vielleicht kann man da ja zusammen arbeiten.
]]></description><link>https://forum.iobroker.net/topic/81378/vorschlag-rag-system-für-die-doku</link><guid isPermaLink="true">https://forum.iobroker.net/topic/81378/vorschlag-rag-system-für-die-doku</guid><dc:creator><![CDATA[Holger Will]]></dc:creator><pubDate>Mon, 16 Jun 2025 06:50:03 GMT</pubDate></item><item><title><![CDATA[Doku: Anregung für Meeting März]]></title><description><![CDATA[@feuersturm (Kopie zur Sicherheit an @apollon77)
Das war eigentlich auch der Plan :-)
Aber es scheint ja in dieser Kategorie auch den Einen oder Anderen erreicht zu haben.
Einen schönen Sonntag noch in die Runde.
]]></description><link>https://forum.iobroker.net/topic/73164/doku-anregung-für-meeting-märz</link><guid isPermaLink="true">https://forum.iobroker.net/topic/73164/doku-anregung-für-meeting-märz</guid><dc:creator><![CDATA[Rico Sander]]></dc:creator><pubDate>Sat, 02 Mar 2024 20:02:29 GMT</pubDate></item><item><title><![CDATA[Änderungsvorschlag (PR)]]></title><description><![CDATA[@mcm57
Oi, ja danke. Das sollte ich später mal selbst tun, oder? Geht das direkt aus GitHub?
(Also doch noch nicht alles gelernt).
:-)
]]></description><link>https://forum.iobroker.net/topic/73122/änderungsvorschlag-pr</link><guid isPermaLink="true">https://forum.iobroker.net/topic/73122/änderungsvorschlag-pr</guid><dc:creator><![CDATA[Rico Sander]]></dc:creator><pubDate>Thu, 29 Feb 2024 12:40:54 GMT</pubDate></item><item><title><![CDATA[Starthilfe erbeten]]></title><description><![CDATA[@apollon77
Ja, wenn man direkt auf der GH Seite editieren will und noch keinen Fork hat, dann legt GH einen an. Muss man nur bestätigen dass man das will / erlaubt.
]]></description><link>https://forum.iobroker.net/topic/73116/starthilfe-erbeten</link><guid isPermaLink="true">https://forum.iobroker.net/topic/73116/starthilfe-erbeten</guid><dc:creator><![CDATA[mcm1957]]></dc:creator><pubDate>Thu, 29 Feb 2024 10:30:36 GMT</pubDate></item><item><title><![CDATA[Anregung Thema Updates]]></title><description><![CDATA[Hi,
interessantes Thema. Ich habe das Gefühl (was das Thema nicht abwerten soll!) das @Ro75 zur Minderheit der User gehört die die Details wissen wollen und verstehen wollen. Die allermeisten updaten nur und genug klicken auch Hinweise zu Breaking changes weg ud wundern sich das es dann nicht geht. ;-)  (nein, ich wikll nicht die Diskussion erweitern!)
Generell stimme ich zu das, wenn es sinnvoll ist, man mehr Details als Entwickler liefern kann. In vielen Fällen würde das aber mehr Infos verursachen, die dann wieder noch weniger User lesen. Oder man müsste wirklich Admin und GitHub News/Changelog getrennt erstellen was wieder viel Aufwand beim Entwickler verursacht. Auf Issues verlinken mag eine Idee zu sein, aber aus der Erfahrung liesst das erst recht wieder "keiner" weil sich auch da ja ggf Seitenlange Diskussionen mit Logfiles und Iterationen von Änderungen verbergen - aber es eine End-Zusammenfassung am Ende nie gibt.
Wenn ich als Entwickler Fehler behebe die berichtet wurden oder Sentry-Crashes abarbeite dann steht da ein "Prevent Crash cases" im changelog weil es so ist - auch wenn ich verstanden habe wann die Zustandegekommen sind bin ich der Meinung das es nicht zielführend ist das zu erklären weil teilweise sehr speziell.
Bei Adaptern wie Alexa2 oder Meross oder so wo es am Ende externe Systeme der Hersteller gibt versuche ich immer zu schreiben ob Änderungen aufgrund von Änderungen der Hersteller gemacht wurden oder ob es Feature sind die dazu kommen. Aber auch bin ich nicht des Mehrwerts eines "ins Detail gehen" sicher.
Das Ziel des "Stable" Repos ist es das man idealerweise Adapter updaten kann wie seine Windows oder App-Store software ... da liesst doch auch keiner Changelogs - soweit es die überhaupt sinnvoll gibt. Stable Updates waren vorher mindestens 2 Wochen in latest ... wer hier sicherstellen will ob es Fehler gibt schaut idealerweise ins GitHub. Aber die Erwartung ist das es simpel ist. Das gute bei ioBroker ist das man im Einzelfall sich nur die alte Version merken (oder aus Logfile ziehen muss) und wieder downgraden kann. Und das ist - von viel Feedback - das was, meiner Erfahrung nach, die meisten User wollen. Update und es geht.
Es gibt immer Sonderfälle - sei es "uralt Tablet Inkompatibilitäten in Vis" die unabsichtlich reinkommen weil kein Entwickler so ein altes Gerät hat und. Muss gemeldet werden und dann kann man entscheiden ob es gefixt wird oder halt so ist (Ja vor allem bei "Uralt Browsern" ist das immer eine Diskussion - kenn ich auch aus der Firma :-) )
Bei einem Adapter wie "zigbee" wegen Probleme in einzelnen Versionen komplett alles neue zu verteufeln ist auch der falsche Ansatz :-)
Also lange rede kurzer Sinn: Man kann das Thema gern mal mit ins nächste Entwicklermeeting nehmen um dort noch einmal die Entwickler zu bitten detaillierter zu sein und nicht zu knapp - wenn sinnvoll. Ich glaube aber das Du da eine Ausnahme bist (vllt neben mir selbst ... ich schaue in meinem Produktivsystem auch eher 3 mal hin bevor ich was aktualisiere).
Ingo
]]></description><link>https://forum.iobroker.net/topic/72461/anregung-thema-updates</link><guid isPermaLink="true">https://forum.iobroker.net/topic/72461/anregung-thema-updates</guid><dc:creator><![CDATA[apollon77]]></dc:creator><pubDate>Sat, 03 Feb 2024 10:59:31 GMT</pubDate></item><item><title><![CDATA[Adapter-Doku auf Github aktualisieren]]></title><link>https://forum.iobroker.net/topic/64156/adapter-doku-auf-github-aktualisieren</link><guid isPermaLink="true">https://forum.iobroker.net/topic/64156/adapter-doku-auf-github-aktualisieren</guid><pubDate>Sun, 26 Mar 2023 11:19:12 GMT</pubDate></item><item><title><![CDATA[Aufruf zur Unterstützung für Backitup Wiki]]></title><description><![CDATA[@crunchip sagte in Aufruf zur Unterstützung für Backitup Wiki:

@tt-tom sagte in Aufruf zur Unterstützung für Backitup Wiki:

Und dieser Token ist der Root-Token.

https://www.rajchert.net/?p=1026

Aufgrund des defekten Links habe ich eine eigene Anleitung geschrieben.
https://github.com/simatec/ioBroker.backitup/wiki/Diverse-Anleitungen-für-ioBroker.backitup#operator-token-für-influxdb-2x-wiederherstellen
]]></description><link>https://forum.iobroker.net/topic/63694/aufruf-zur-unterstützung-für-backitup-wiki</link><guid isPermaLink="true">https://forum.iobroker.net/topic/63694/aufruf-zur-unterstützung-für-backitup-wiki</guid><dc:creator><![CDATA[simatec]]></dc:creator><pubDate>Thu, 09 Mar 2023 10:45:12 GMT</pubDate></item><item><title><![CDATA[Git clone iobroker.docs unter Windows nicht möglich]]></title><description><![CDATA[@feuersturm sagte in Git clone iobroker.docs unter Windows nicht möglich:

Kennt jemand eine Alternative / Workaround, wie ich unter Windows so ein Repository clonen kann?

Du könntest einen sparse checkout probieren, bei dem das Verzeichnis nicht ausgecheckt wird.
https://stackoverflow.com/a/63786181/10179833
]]></description><link>https://forum.iobroker.net/topic/52847/git-clone-iobroker-docs-unter-windows-nicht-möglich</link><guid isPermaLink="true">https://forum.iobroker.net/topic/52847/git-clone-iobroker-docs-unter-windows-nicht-möglich</guid><dc:creator><![CDATA[AlCalzone]]></dc:creator><pubDate>Wed, 23 Feb 2022 22:40:52 GMT</pubDate></item><item><title><![CDATA[Nutzung von draw.io  für Grafiken in der Doku]]></title><description><![CDATA[@ostfrieseunterwegs sagte in Nutzung von draw.io für Grafiken in der Doku:

Weil es Cloud oder Desktop anbietet.

und den hab ich nicht mehr gefunden.
Bist du sicher, dass das nicht nur ein Frontend-Install ist, die Arbeit aber offline gar nicht möglich ist
]]></description><link>https://forum.iobroker.net/topic/52083/nutzung-von-draw-io-für-grafiken-in-der-doku</link><guid isPermaLink="true">https://forum.iobroker.net/topic/52083/nutzung-von-draw-io-für-grafiken-in-der-doku</guid><dc:creator><![CDATA[Homoran]]></dc:creator><pubDate>Tue, 01 Feb 2022 23:04:52 GMT</pubDate></item><item><title><![CDATA[Gedanken zu: Entwicklung geht zu schnell und allgemein Dokus]]></title><link>https://forum.iobroker.net/topic/51955/gedanken-zu-entwicklung-geht-zu-schnell-und-allgemein-dokus</link><guid isPermaLink="true">https://forum.iobroker.net/topic/51955/gedanken-zu-entwicklung-geht-zu-schnell-und-allgemein-dokus</guid><pubDate>Sun, 30 Jan 2022 09:25:48 GMT</pubDate></item><item><title><![CDATA[Adapter heatingcontrol Doku]]></title><description><![CDATA[@rene_hm sagte in Adapter heatingcontrol Doku:

@andreas-5 Der Fehler im heatingcontrol-Adapter wurde gefunden und wird demnächst behoben. ABER: die gleiche Doku steht im github in der jeweiligen readme des Adapters.

Hi Rene,
danke, da habe ich inzwischen auch den link bekommen, wie ich auf github die Doku in Deutsch finde und werde mich damit beschäftigen, sobald ich zu Hause wieder Zeit dafür finde.
]]></description><link>https://forum.iobroker.net/topic/51853/adapter-heatingcontrol-doku</link><guid isPermaLink="true">https://forum.iobroker.net/topic/51853/adapter-heatingcontrol-doku</guid><dc:creator><![CDATA[Andreios]]></dc:creator><pubDate>Thu, 27 Jan 2022 10:59:19 GMT</pubDate></item><item><title><![CDATA[Diskussion zur Strukturierung einer Doku-Seite]]></title><description><![CDATA[@oliverio sagte in Diskussion zur Strukturierung einer Doku-Seite:

oder gar neu mit Linux. Viele Begriffe, Befehle die im Forum so rumschwirren sind böhmische Dörfer. man hat überhaupt gar keine Ahnung was es bedeutet

richtig,
ein Beispiel
der User schildert sein Problem,
man antwortet, zeig mal die Ausgabe von
iob update -i
apt policy nodejs

als Antwort erhält man die Ausgabe, mit dem Text, Fehler besteht weiterhin
es gibt soviele User die hier um Rat fragen, man geht das Problem mit ihm durch, letztendlich aber gar keinen Plan haben, was sie da eigentlich abtippen, bzw was diese Befehle bewirken/bedeuten.
Man kann nicht erwarten, das man sich vorher komplett einliest in sämtlichen Themenbereiche, die Zielgruppen sind total unterschiedlich, vereinfacht ausgedrückt
der eine möchte etwas steuern, "bisschen Smarthome", der andere etwas auslesen, Statistiken..(Strom,Heizung),
User A sucht bewusst nach einer Möglichkeit dies zu tun, User B kommt durch Zufall auf iobroker.
Schnell installiert(stellt sich das leichter vor als gedacht), und nun erkennt er erst, was da alles dran hängt, was da alles zu tun ist, mit was man sich alles auseinander setzen muss und denkt sich...ich wollte doch eigentlich nur...
doch da ist er schon mittendrin und letzendlich hilflos
anderes Beispiel
Probleme bei der Installation einer InfluxDb, klar man kann auf die offizelle Seite verweisen, ein Linuxfremder tut sich da allerdings sehr schwer,
zum einen, weil er die Bedeutung der Befehle nicht kennt, nicht versteht, was er da eingeben muss, das mancher Befehl noch angepasst werden muss, oder gar die Info fehlt, dass das ein oder andere Packet noch nachinstalliert werden muss
]]></description><link>https://forum.iobroker.net/topic/51820/diskussion-zur-strukturierung-einer-doku-seite</link><guid isPermaLink="true">https://forum.iobroker.net/topic/51820/diskussion-zur-strukturierung-einer-doku-seite</guid><dc:creator><![CDATA[crunchip]]></dc:creator><pubDate>Wed, 26 Jan 2022 10:38:04 GMT</pubDate></item><item><title><![CDATA[Formelle Gesichtspunkte zur Doku]]></title><description><![CDATA[Soweit ich mich erinnern kann, sollte eigentlich wie in Variante 1 geschrieben werden, jedoch liegt das an der Übersetzung in mehreren Sprachen und funktioniert so nicht, daher hatte ich beim Schreiben Variante 2 verwendet.
]]></description><link>https://forum.iobroker.net/topic/51808/formelle-gesichtspunkte-zur-doku</link><guid isPermaLink="true">https://forum.iobroker.net/topic/51808/formelle-gesichtspunkte-zur-doku</guid><dc:creator><![CDATA[crunchip]]></dc:creator><pubDate>Tue, 25 Jan 2022 20:11:43 GMT</pubDate></item><item><title><![CDATA[Grundidee der Themenausrichtung der Doku]]></title><description><![CDATA[@paul53 sagte:

@homoran sagte: Ist alles gemerged
content.md noch nicht?

Doch! 
Danke für den Tritt!
Hatte es irgendwie verschlafen.
Github hatte sich immer wieder aufgehängt ("Checking for automerge" oder so), da muss ich es übersprungen haben
]]></description><link>https://forum.iobroker.net/topic/51794/grundidee-der-themenausrichtung-der-doku</link><guid isPermaLink="true">https://forum.iobroker.net/topic/51794/grundidee-der-themenausrichtung-der-doku</guid><dc:creator><![CDATA[Homoran]]></dc:creator><pubDate>Tue, 25 Jan 2022 13:30:23 GMT</pubDate></item><item><title><![CDATA[Grundlagen der Struktur hinter der Doku]]></title><link>https://forum.iobroker.net/topic/51731/grundlagen-der-struktur-hinter-der-doku</link><guid isPermaLink="true">https://forum.iobroker.net/topic/51731/grundlagen-der-struktur-hinter-der-doku</guid><pubDate>Sun, 23 Jan 2022 19:08:52 GMT</pubDate></item><item><title><![CDATA[Formatierungshilfe gesucht]]></title><description><![CDATA[@crunchip
@AlCalzone
sieht auf github schon mal vielversprechend aus
[image: 1642776951518-readmore_md.png]
Mal sehen wie es auf der Website nach dem nächsten Build aussieht
DANKE
]]></description><link>https://forum.iobroker.net/topic/51619/formatierungshilfe-gesucht</link><guid isPermaLink="true">https://forum.iobroker.net/topic/51619/formatierungshilfe-gesucht</guid><dc:creator><![CDATA[Homoran]]></dc:creator><pubDate>Fri, 21 Jan 2022 13:37:54 GMT</pubDate></item><item><title><![CDATA[Neue Kategorie Dokumentationssupport]]></title><description><![CDATA[@homoran Möchte mich auch an der Doku beteiligen. Hatte mir die Unterseite Repository schon einmal geschnappt und dort auch schon etwas bei mir vorbereitet.
Werde auch noch einmal den link prüfen den du mir geschickt hattest.
Kann heute abend schon einmal einen Beitrag im Unterforum posten.
]]></description><link>https://forum.iobroker.net/topic/51617/neue-kategorie-dokumentationssupport</link><guid isPermaLink="true">https://forum.iobroker.net/topic/51617/neue-kategorie-dokumentationssupport</guid><dc:creator><![CDATA[Feuersturm]]></dc:creator><pubDate>Fri, 21 Jan 2022 12:54:05 GMT</pubDate></item></channel></rss>