Jahresrückblick 2025 – unser neuer Blogbeitrag ist online! ✨

[Homoran]

Du sprichst ein vielschichtiges Thema an!
Abgesehen davon, dass die Doku von jedem über einen pullrequest angepasst werden kann, da ein einzelner das bicht schaffen kann, stellt sich die Frage wie weit diese Dokus gehen sollen.

Der User, der ioBroker nutzen will, sollte auch mit dem Grundsystem umgehen können.
komplexe Systeme wie Docker, Proxmox oder andere Virtualisierungen sind nette Zusatzfeatures aber nicht die Aufgabe von ioBroker, diese zu erklären, geschweige denn zu supporten. Auch wenn die Helfenden es immer wieder tun.

Für Docker() und Proxmox (https://www.iobroker.net/#de/documentation/install/proxmox.md) gibt es sogar Anleitungen.
Aber auch so etwas muss dauernd von irgendjemand gepflegt werden.

Wie du bei Windows gesehen hast, ist es dort nicht so trivial.
Der erste Installer ist quasi nur als proof of concept entstanden, nach dem Motto "das muss doch auch gehen".
Natürlich ist Windows nicht statisch und der arme Einzelkämpfer kam bei Updates vom M$ nicht mehr mit den Äderungen nach.
Auch die Doku muss dann dauernd angepasst werden.

Für die Äpfel ist das nicht einfacher.

---

Wie weit soll so eine Doku gehen?
Muss auch noch der Zusammenbau eines PC, die Installation von Adapterspezifischer Software o.ä. für alle Plattformen und Varianten enthalten und gepflegt werden?

[Codierknecht]

@homoran
Im Prinzip gebe ich Dir völlig Recht.
Dass das eine Sisyphus-Arbeit ist, dürfte klar sein.

Der User, der ioBroker nutzen will, sollte auch mit dem Grundsystem umgehen können.

Das wäre zu schön um wahr zu sein ;-)

dass die Doku von jedem über einen pullrequest angepasst werden kann

Zumindest das Repo habe ich schon mal gefunden.
Ich schau mal, ob ich nicht an der einen oder anderen Stelle ein wenig helfen kann.

[Codierknecht]

@homoran sagte in Doku zur Installation:

Abgesehen davon, dass die Doku von jedem über einen pullrequest angepasst werden kann

Habe mir gerade mal den Windows-Bereich im Repo angesehen.
Als erster Satz steht dort:

?> Dieser Artikel wird gerade erweitert.

@Bluefox
Fühlt sich hier jemand angesprochen?
Wird da tatsächlich aktiv dran gearbeitet? Oder ist das mittlerweile obsolet?
Konflikte zu verursachen ist ja jetzt auch nicht gerade Sinn der Sache.
Die Links im Dokument sind auch meist tot - also z.B. zum StyleGuide oder den Installationsvoraussetzungen.

[crunchip]

@codierknecht sagte in Doku zur Installation:

Ich schau mal, ob ich nicht an der einen oder anderen Stelle ein wenig helfen kann.

https://forum.iobroker.net/category/187/arbeitsgruppen

[Codierknecht]

@crunchip
Mir geht es aktuell vorrangig um das Thema "Installation".
Dazu hatte ich keine Arbeitsgruppe gefunden.
Heißt das, ich mache einfach eine auf?

[Homoran]

@codierknecht sagte in Doku zur Installation:

Dass das eine Sisyphus-Arbeit ist, dürfte klar sein.

ich habe fast 8 Jahre die Userdokus auf den verschiedenen Plattformen nahezu alleine gemacht.
Irgendwann wurde es zuviel, da habe ich mich aufs Forum beschränkt, was ursprünglich nur war, um Feedback für die Doku an der Basis abzuholen.

Das ist für mich immer noch ein sehr wichtiger Aspekt, damit die Doku nicht zu einer technischen Nerd-Doku verkomnt.

[crunchip]

@codierknecht sagte in Doku zur Installation:

ich mache einfach eine auf?

kannst du, wenn du z.b. zwischenzeitlich zum Thema Nachfragen etc hast, musst du aber nicht zwangsläufig.

@codierknecht sagte in Doku zur Installation:

Wird da tatsächlich aktiv dran gearbeitet? Oder ist das mittlerweile obsolet?
Konflikte zu verursachen ist ja jetzt auch nicht gerade Sinn der Sache.

dafür waren die Gruppen gedacht

denke, das steht pauschal noch aus früheren Zeiten drin(2019) zuletzt bearbeitet

[Homoran]

@codierknecht sagte in Doku zur Installation:

Als erster Satz steht dort:

?> Dieser Artikel wird gerade erweitert.

das war so ziemlich meine letzte Aktion, als ich die Struktur für das aktuelle Doku Framework erstellt habe.
Diese Struktur musste vorher festgeschrieben werden, damit u.a. die Menüstruktur erstellt werden, und das Umschalten zwischen den Sprachversionen funktionieren konnte.

Habe dann aber nur die Seiten konvertieren oder neu schreiben können, zu denen ich etwas sagen konnte.

in allen anderen ist der Platzhalter leider geblieben, obwohl wir mehrere bis viele Anläufe unternommen haben über diverse Kanäle Helfer zu motivieren.

der verlinkte Thread / Unterforum ist nur eine davon.

[Homoran]

@codierknecht sagte in Doku zur Installation:

Dazu hatte ich keine Arbeitsgruppe gefunden.

willst du eine?

Solange du alleine bist......

[Codierknecht]

@homoran sagte in Doku zur Installation:

damit die Doku nicht zu einer technischen Nerd-Doku verkomnt

Genau das meinte ich mit (sinngemäß)

Der Entwickler ist relativ ungeeignet, die Doku zu schreiben

in dem Thread zur Installation unter Mac.
Wenn ich zu meinen Dingen dann mal Doku schreibe (meist erst nach Aufforderung), artet das auch schnell zu etwas seeehr technischem aus, in dem es von Fachbegriffen nur so wimmelt. Da verstehen die Anwender oft nur noch Bahnhof.

[Codierknecht]

@homoran sagte in Doku zur Installation:

willst du eine?
Solange du alleine bist......

... ist das wohl erstmal nicht nötig.
Auf der anderen Seite: Wenn es eine gibt wissen, wenigstens andere auch gleich wer daran arbeitet.
Usernamen in GitHub und hier im Forum lassen sich ja auch nicht 1:1 übersetzen.

[crunchip]

@homoran ich dachte dazu ist der Thread Arbeitsgruppen

@homoran sagte in Was passiert hier?:

Hier in dieser Kategorie soll pro zu bearbeitende Seite ein Thread aufgemacht werden können, in dem dann MItarbeitende sich austauschen können.
Außerdem kann hier dann jeder seine Meinung, Anregung zu dieser Seite kundtun

[Homoran]

@crunchip sagte in Doku zur Installation:

ich dachte dazu ist der Thread Arbeitsgruppen

ja!
da hast du recht.

da gibt es keine Unter-Unterkategorien.
Der Thread ist die Gruppe!

[sigi234]

@codierknecht

Als 1. sollte der Neue Windows Installer Fehlerfrei laufen, dann die Doku.
Ein Hinweis in der alten Doku auf den Neuen Installer wäre gut. :relaxed:

Gerne helfe ich bei der Neuen Doko dann mit.

[Homoran]

fann schieb ich das jetzt in die Arbeitsgruppen!
jetzt wo ihr schon zu zweit seid!

[Codierknecht]

@sigi234 sagte in Doku zur Installation:

Als 1. sollte der Neue Installer Fehlerfrei laufen, dann die Doku.

Wenn ich @apollon77 richtig verstanden habe, gibt er die letzten Erkenntnisse noch weiter, um das in den Installer einfließen zu lassen.

Ein Hinweis in der alten Doku auf den Neuen Installer wäre gut.

Vielleicht kann das jemand "on the fly" in das Dokument prömpeln (ohne Pull-Request)

Gerne helfe ich bei der Neuen Doko dann mit.

Ich kann natürlich auch nur dort helfen, wo ich selbst Erfahrungen sammeln konnte.
Bei Mac z.B. bin ich raus und auch Linux ist für mich noch ein Buch mit sieben Siegeln.
Bleibt Windows und Docker auf Synology (DSM 6)

[crunchip]

@codierknecht sagte in Doku zur Installation:

Bleibt Windows

wäre dann https://github.com/ioBroker/ioBroker.docs/edit/master/docs/de/install/windows.md

[Codierknecht]

@crunchip
Jepp - Fork ist erstellt.

[Homoran]

@codierknecht sagte in Doku zur Installation:

Docker auf Synology (DSM 6)

da geht es schon los!

• ist die Installation von a) Docker auf einer b) Synology ein ioBroker Thema
  • was ist mit anderen Möglichkeiten auf der Synology (Bezeichnungen fallen mir gerade nicht ein)
  • was ist mit Docker auf RasPi, auf Debian und tatsächlich auch in Proxmox schon dagewesen.

Warum dann DSM6 wo DSM7 schon lange raus ist.
außer natürlich bei älteren DS

---

nur mal so ein Blick in die Büchse der Pandora

[Codierknecht]

@homoran sagte in Doku zur Installation:

nur mal so ein Blick in die Büchse der Pandora

Da gebe ich Dir durchaus Recht.
Muss ja nicht in voller Schönheit breitgetreten werden.
Ein Verweis auf ein anderes Dokument würde durchaus reichen.
Ich stelle mir das AdHoc als Kapitel am Ende vor, in dem dann die Sonderfälle gelistet werden und auf ein eigenes Dokument verlinken.
Natürlich muss sich jemand um die Aktualisierung dieser Sonderfall-Dokumente kümmern. Im Idealfall betreuen dann mehrere User (Autoren) ein Thema.
Mit Threads im Forum ist es meiner Ansicht nach nicht getan, denn wie wir dort regelmäßig sehen, landen die User dann bei einem völlig veralteten Thread und verstrubbeln sich völlig.