Grundidee der Themenausrichtung der Doku

[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.

[derAlff]

@muchul Findet die implementierte Suchfunktion dann auch nichts?
Ich denke schon. Daher die Frage, kann man auf Webseiten den Tastendruck "Strg+F" abfangen und die Suchfunktion aktivieren?

[paul53]

@homoran sagte: Was genau aber sind dann Funktionen?

In HomeMatic: Gewerke

[Homoran]

@paul53 sagte:

Meinst Du die docs/content.md?

nein, die existiert, aber eine docs/de/alias.md oder wie immer der richtige Pfad wäre in allen Sprachen, wenn ein neuer Menüpunkt Alias angelegt wird

[paul53]

@homoran sagte: nein, die existiert

Ja, muss aber vielleicht angepasst werden?

@homoran sagte in Grundidee der Themenausrichtung der Doku:

eine docs/de/alias.md oder wie immer der richtige Pfad wäre in allen Sprachen

Ich habe die Datei alias.md unter allen 4 Sprachpfaden erstellt (deshalb 5 PRs).