NEWS
Neue Dokumentation ins nächste Level heben
-
@Homoran sagte in Neue Dokumentation ins nächste Level heben:
Das reicht allei e nicht, auch das Menü muss angepasst werden.
Ja aber es ging darum was die Helfer machen müssen, nicht wir. Deswegen halte ich solche Sachen raus, es soll ja so einfach wie möglich sein.
-
@Jey-Cee sagte in Neue Dokumentation ins nächste Level heben:
was die Helfer machen müssen,
Eben!
Bevor irgendwelche nur Seiten geschrieben werden sollte immer geklärt werden wo die hin soll und ob das möglich ist.
Sonst machen sich die Helfer unnötige Arbeit!
Das gleiche gilt für existente aber irgendwo verschollene Seiten.
Ich werde sobald ich nach der Dienstreise die Zeit finde, versuchen solche Leichen wieder sichtbar zu machen.
Daher würde es erstmal reichen fehlende Seiten (besonders wenn sie in der alten Doku existierten) aufzulisten/zu melden!
-
-
@Mic
Danke!Aber:
Auffällig ist, dass der Titel laut Seitenleiste "Tutorial" unter dem Hauptpunkt "Tutorials" ist, aber der Dateiname "updates.md". Sollte vielleicht auch gelegentlich korrigiert werden.
Das ist was ich meinte.
Da steht (oder soll stehen) die geplante oder im Datennirvana verschollene Seite zum Tutorial für das korrekte updaten hinter.Der Einfachheit halber heißen die Menüpunkte immer gleich und werden automatisch umbenannt wenn der Titel im Header der Datei eingetragen wird
-
Im Header der Datei steht ja "Tutorial":
--- title: "Tutorial" lastChanged: "14.09.2018" ---
@Homoran sagte in Neue Dokumentation ins nächste Level heben:
Der Einfachheit halber heißen die Menüpunkte immer gleich und werden automatisch umbenannt wenn der Titel im Header der Datei eingetragen wird
Bedeutet also, wenn ich den Header-Titel z.B. von "Tutorial" in "JavaScript-Tutorial" ändere, dass ihr dann den Menüpunkt in der Doku, also links in der Navigation ersichtlich, automatisch anpasst?
Oder wie sollen wir solche Änderungen aktiv mitgestalten? Oder einfach einen Beitrag hier im Forum? -
@Mic sagte in Neue Dokumentation ins nächste Level heben:
Bedeutet also, wenn ich den Header-Titel z.B. von "Tutorial" in "JavaScript-Tutorial" ändere, dass ihr dann den Menüpunkt in der Doku, also links in der Navigation ersichtlich, automatisch anpasst?
Ja!
Aber bitte nicht in der Datei updates.md!
Wie du siehst heißt die Datei updates.md und bevor du deinen Text getippt hast heißt es in der Hauptüberschrift:
Durchführen von Updates
-
Und die Seitennavigation dazu heißt "Tutorial", und nicht "Updates
Daher hab ich dort die Änderungen eingebaut, ohne Dateinamen zu beachten.
Daher meine Frage. Also wo darf ich ändern, wo nicht, und was hat es dann für eine Auswirkung? Dateien umbenennen mache ich natürlich nicht.Übrigens "Durchführen von Updates" wird gar nicht angezeigt, nur im Editor
-
Vielleicht noch mal zu meiner Vorgehensweise:
Ich möchte ein paar Links zur Doku hinzufügen, um es den Anwendern zu erleichtern. Lt. https://forum.iobroker.net/post/271751 am besten JavaScript unter Tutorials. Da es sehr wenig Unterpunkte gibt, hab ich die quasi leere Seite "Tutorial" genommen.
Dort via GitHub angepasst. -
@Mic sagte in Neue Dokumentation ins nächste Level heben:
Und die Seitennavigation dazu heißt "Tutorial", und nicht "Updates
Weil es, wie du schon gemerkt hast, so im Header steht.
Ein pullrequest bezieht sich aber immer auf die Datei.
Wenn du mehr machen willst melde ich mich Ende der Woche Mal.
Bin im Moment dienstlich unterwegs und nur am Handy im Hotel -
Gerne @Homoran, melde Dich einfach. Sorry für die Umstände die du hast, das macht es nicht leicht.
Aber ich helfe gerne bei der Doku mit, cooles Konzept mit Github-Integration. Bekommen wir dank der Community schon gut hin. -
Nachdem ich die Doku zum "Kernkonzept" auf Github etwas überarbeitet habe, was auch durch @Bluefox auf Github "merged" wurde, vermisse ich die Änderungen in der Doku https://www.iobroker.net/#de/documentation/dev/objectsschema.md.