Grundidee der Themenausrichtung der Doku

[apollon77]

@homoran "IoT Technologien und Protokolle" :-))

[Homoran]

@andreas-5 sagte in Grundidee der Themenausrichtung der Doku:

Eine Struktur, die 2018 aus dem Grund der Mehrsprachigkeit erstellt, aber bis 2022 noch nicht mit Inhalt gefüllt worden ist,

auch wenn 2022 noch seeehr lange dauern wird, hast du leider Recht.

Aber die Struktur ist nicht zu hinterfragen, nur die fehlenden Inhalte.

JeyCee hat ja klar gemacht, dass ihn eine kurze Seite schon Stunden gekostet hat, da kann man sich ja mal ausrechnen, was mich hunderte Seiten bisher gekostet haben.

Erschwerend kam hinzu, dass die Userzahl dermaßen gestiegen ist, dass ich mich entscheiden musste im Forum zu helfen, oder die Doku weiterzuschreiben, was ich auch aus Gründen, wie sie @crunchip gerade in einem anderen Thread beschrieben hat erst einmal zurückgestellt hatte. Auch hatte ich die damals eigentlich noch berechtigte Hoffnung, im Forum die Knackpunkte herauszuarbeiten, die ich dann in der Doku behandeln wollte.

Leider kamen auch noch andere Dinge dazwischen und irgendwann reichten 24 Stunden einfach nicht mehr aus.
Deswegen machen wir hier ja den nächsten Anlauf, diesmal mit größerem Trara.

@andreas-5 sagte in Grundidee der Themenausrichtung der Doku:

Das habe ich gelesen, allerdings nicht sehr intensiv!

dann mach das, vielleicht verstehst du dann, warum an der Struktur (eigentlich) nichts zu rütteln ist

[paul53]

@homoran
Was war für "Funktionen" unter "Grundlagen" angedacht?
Die Rubrik "Adapter und Controller" sollte wohl besser "Adapter und Instanzen" lauten?

[Homoran]

@paul53 sagte:

Was war für "Funktionen" unter "Grundlagen" angedacht?

Als ich letzte Woche die Menütitel überarbeitet hatte, habe ich mich das auch gefragt.
Habe gerade nochmal reingesehen, ob anhand der anderen Übersetzungen da was hilfreiches drinsteht

        "Functions": {
          "title": {
            "en": "Functions",
            "de": "Funktionen",
            "ru": "Функции",
            "zh-cn": "职能"
          },

leider Fehlanzeige

Aus dem Zusammenhang, dass der Menüpunkt davor Datenpunkte und Objekte heisst, nehme ich an, dass da die "Gewerke" usw, also die enums hinsollten

EDIT:

@paul53 sagte in Grundidee der Themenausrichtung der Doku:

Die Rubrik "Adapter und Controller" sollte wohl besser "Adapter und Instanzen" lauten?

Auch das ging mir durch den Kopf, dann musste ich an den Befehl iobroker update denken, da stehen die Adapter und der Controller drin

Vielleicht sollten dort Controller, Adapter und Instanzen behandelt werden um die gesamte zusammenhängende Organisationsstruktur des modularen Aufbaus verständlich zu machen.
Allerings müsste der Menütitel kürzer sein

[Andreios]

@homoran sagte in Grundidee der Themenausrichtung der Doku:

@andreas-5 sagte in Grundidee der Themenausrichtung der Doku:

Aber die Struktur ist nicht zu hinterfragen, nur die fehlenden Inhalte.

Ich hinterfrage grundsätzlich alles, was mir nicht sinnvoll erscheint! Und in der heutigen Zeit und bei einem tollen System, das so flexibel ist, wie ioBroker, kann man sich ja schon 'mal fragen, ob eine so Starre Struktur der Doku sinnvoll ist.

JeyCee hat ja klar gemacht, dass ihn eine kurze Seite schon Stunden gekostet hat, da kann man sich ja mal ausrechnen, was mich hunderte Seiten bisher gekostet haben.

Wenn es am System liegt, dass es Stunden gekostet hat, dann sollte man das System doch erst Recht überdenken, oder?

dann mach das, vielleicht verstehst du dann, warum an der Struktur (eigentlich) nichts zu rütteln ist

Manchmal muss man alte Stricke abschneiden!

[apollon77]

@homoran sagte in Grundidee der Themenausrichtung der Doku:

an, dass da die "Gewerke" usw, also die enums hinsollten

würde ich auch tippen

[paul53]

@homoran sagte: die enums hinsollten

Dann sollte man die Rubrik auch so bezeichnen (en: enums, de: Aufzählungen). Und davor noch Alias als Datenpunkte mit speziellen Eigenschaften einfügen.

[Jey Cee]

@andreas-5 sagte in Grundidee der Themenausrichtung der Doku:

Wenn es am System liegt, dass es Stunden gekostet hat, dann sollte man das System doch erst Recht überdenken, oder?

Hat es nicht, zumindest nicht maßgeblich. Aber man muss sich Gedanken zum Aufbau machen und dann noch zum Inhalt. Am Ende muss dann auch noch die Formulierung passen.

Das sind einfach Dinge um die man nicht herum kommt. Jemand der sich leichter tut mit schreiben ist sicher deutlich schneller als ich. Trotzdem ist das nicht mal so in ein paar Minuten erledigt.

[Homoran]

@andreas-5 sagte in Grundidee der Themenausrichtung der Doku:

Wenn es am System liegt, dass es Stunden gekostet hat, dann sollte man das System doch erst Recht überdenken, oder?

richtig, aber er hat ja nur in seinem eigenen Repo getippt.
und da sind noch nicht einmal beschriftete Screenshots drin
Also ist die Struktur unschuldig.

Die kommt erst richtig zur Geltung, wenn anschließend alles automatisch generiert wird. Wie im Link beschrieben.

@andreas-5 sagte in Grundidee der Themenausrichtung der Doku:

Manchmal muss man alte Stricke abschneiden!

s.o.
Dann darfst du ein neues Framework für das gesamte ioBroker-System programmieren.
(siehe Link)

[Homoran]

@paul53 sagte:

Und davor noch Alias als Datenpunkte mit speziellen Eigenschaften einfügen.

wenn ich darf

Ich hoffe dabei zerschieße ich nichts.
Ich würde bevorzugen, wenn das jemand macht, der sich mit Programmierung und hier wohl mit JSON-Strukturen auskennt

[Chaot]

@homoran sagte in Grundidee der Themenausrichtung der Doku:

Leider kamen auch noch andere Dinge dazwischen und irgendwann reichten 24 Stunden einfach nicht mehr aus.
Deswegen machen wir hier ja den nächsten Anlauf, diesmal mit größerem Trara.

Was hältst du (haltet ihr) davon die Arbeit öffentlich zu teilen?
Ja, ich habe gesehen das es auch in der Dokumentation die Möglichkeit gibt, aber man könnte das auch hier machen.
Nicht jeder arbeitet gerne/oft mit Github.

Ich danke da an einen Tread mit einem Aufruf zur Mithilfe. Im Eingangspost die Titel die benötigt werden (abgearbeitete werden gelöscht). Die eingehenden Antworten kannst du dann rüberkopieren und hast schon mal den Textaufwand nicht mehr sondern musst das nur noch zurechtformatieren.
Der Tread wird reguliert, also keine Diskussionen sondern nur Dokumentationsbeiträge. Diskussionen werden gelöscht.

Ich denke das sich hier doch ein paar finden werden die zumindest Teile der Dokumentation erklären können. Und wenn aus zwei mittelmäßigen Beiträgen ein guter entsteht hast du dir auch schon einen Tag Arbeit erspart.

[Homoran]

@chaot sagte in Grundidee der Themenausrichtung der Doku:

Was hältst du (haltet ihr) davon die Arbeit öffentlich zu teilen?

Deswegen versuchen wir doch gerade den Ansatz über dieses Unterforum

@chaot sagte in Grundidee der Themenausrichtung der Doku:

Nicht jeder arbeitet gerne/oft mit Github.

gut dass du das schreibst, wollte darauf schon von Anfang an eingehen, vergessen

Jeder der helfen will, kann dies nach seinen Fähigkeiten tun.
Sollte jemand Berührungsängste mit GitHub haben, was durchaus verständlich ist, kann er/sie gerne hier im Forum in einem entsprechenden "Arbeitsgruppen"-Thread den Text in plain Text, oder md anhängen.
Wir bekommen den schon in die Doku
(muss mal sehen wo ich das noch prominent unterbringen kann)

@chaot sagte in Grundidee der Themenausrichtung der Doku:

Im Eingangspost die Titel die benötigt werden

ALLES

@chaot sagte in Grundidee der Themenausrichtung der Doku:

abgearbeitete werden gelöscht

nein, bleiben zur Nachbearbeitung und Diskussion offen

---

Was habe ich falsch gemacht?
Das was du da vorschlägst steckt doch hinter diesem Unterforum

[Chaot]

@homoran sagte in Grundidee der Themenausrichtung der Doku:

Was habe ich falsch gemacht?
Das was du da vorschlägst steckt doch hinter diesem Unterforum

Oh, ich merke gerade das du nichts falsch gemacht hast.
Das Problem ist, das ich nicht über die Forenstruktur einsteige sondern die Themen in der "Aktuell" Ansicht angezeigt bekomme. Da bemerke ich die Unterstruktur nur dann wenn ich explizit darauf achte.
In der Kategorieansicht werden mir komischerweise keine neuen Themen angezeigt (gelber Balken).

[Homoran]

@chaot sagte in Grundidee der Themenausrichtung der Doku:

Das Problem ist, das ich nicht über die Forenstruktur einsteige sondern die Themen in der "Aktuell" Ansicht angezeigt bekomme. Da bemerke ich die Unterstruktur nur dann wenn ich explizit darauf achte.

das geht mir genau so

@chaot sagte in Grundidee der Themenausrichtung der Doku:

das du nichts falsch gemacht hast.

puuuuh

[Homoran]

@paul53 sagte:

Dann sollte man die Rubrik auch so bezeichnen (en: enums, de: Aufzählungen)

Korrigiere mich bitte wenn ich falsch liege.
Ich dachte immer, dass man in den Objekten unter der Spalte Funktionen nach den Aufzählungen filtern kann.

Wenn das stimmt sollte IMHO auch diese Spalte in den Objekten umbenannt werden

[paul53]

@homoran sagte: mit JSON-Strukturen auskennt

Habe 5 PRs erstellt inkl. content.json. Die russische und chinesische Übersetzung für "enums" muss noch korrigiert werden. Bitte mergen. Ich hoffe, dass es so funktioniert.

[paul53]

@homoran sagte: in den Objekten unter der Spalte Funktionen nach den Aufzählungen filtern kann.

Nur nach den Funktionen. Aufzählungen als Oberbegriff enthält auch noch Räume und ggf. Favoriten, ...

[Homoran]

@paul53 sagte:

Bitte mergen

Sorry, betrifft jetzt nicht dich, aber ich musste gerade lachen.
Habe vor ein paar Stunden die deutschen Namen der Menüpunkte zum zweiten Mal geändert, nachdem ein Merge eines 7 Tage alten PullRequests meine damaligen Änderungen wieder überschrieben hatte

Danke für die PRs, ich sehe mir die an.

@paul53 sagte in Grundidee der Themenausrichtung der Doku:

Und davor noch Alias als Datenpunkte mit speziellen Eigenschaften einfügen.

ich weiß nicht mehr ob dann die md-Datei dazu auch in der Struktur angelegt werden muss.
Ich glaube das war der Grund, warum da überall Platzhalter-Seiten stehen

[Homoran]

@paul53 sagte:

Aufzählungen als Oberbegriff enthält auch noch Räume und ggf. Favoriten, ...

Ja das stimmt, Räume (deutsche Übersetzung 'Zimmer') hat ja eine eigene Spalte.

Was genau aber sind dann Funktionen?

Ich denke die Bezeichnunug des Menüpunkts bezieht sich auf diesen Spaltennamen

[paul53]

@homoran sagte: ich weiß nicht mehr ob dann die md-Datei dazu auch in der Struktur angelegt werden muss.

Meinst Du die docs/content.md? Das kann ich nachholen, wenn erforderlich.