NEWS
Neue Dokumentation ins nächste Level heben
-
@Jey-Cee sagte in Neue Dokumentation ins nächste Level heben:
Zu 3.: H1 bedeutet Überschrift ersten Grades. Das andere darüber ist die Kopfzeile. Das ist sehr Technisch ausgedrückt in der Doku für dir Doku.
Soll man diese Kopfzeile anpassen (da steht ja dann ein Datum), oder ignorieren?
-
@Mic ja pass es an. Kaputt machen kann man nix, auf Github wird jede Änderung an einer Datei gespeichert, so kann man immer zurück zu einer früheren Version.
-
Ok, danke.
@Jey-Cee sagte in Neue Dokumentation ins nächste Level heben:
Zu 1.: Dafür muss im entsprechenden Pfad auf Github eine neue Seite erstellt werden.
Wie ist denn hier die Vorgehensweise? Also angenommen, ich will hier "Windows" unterhalb Linux hinzufügen:
Durch Klick auf "Auf Github ändern" wird ja eine neue Fork erstellt. Nur hier weiß ich dann nicht, wie ich weiter vorgehe, und welche Auswirkung es hat, wenn ich etwa jetzt eine neue Seite dort erstelle. Sind ja doch viele Dateien hier:
-
@Mic es hat erst mal keine Auswirkung außer das es eine neue Datei gibt. Die wird auch erstmal separat erstellt und wird mit Pull Request als Vorschlag an die Doku gegeben.
Dann wird sie nochmal geprüft, Formatierung und Inhaltlich, wobei es keine intensiv Prüfung ist. Wenn alles passt wird der PR angenommen, gilt auch für Änderungen an vorhandenen Dateien.Allgemein sollte der Name der Datei nicht lang, aber Aussagekräftig sein. Die Namen sind immer Englisch und enden mit .md
In dem Fall Windows existiert eine, erst mal rein schauen was drin ist und ob man die Überbeiten muss/kann.
Das Verzeichnis in der Doku wird manuell erstellt, soweit ich das weis, deshalb tauchen auch nicht alle Dateien in der Doku auf.Eine neue Datei erstellt man mit dem Button "Create New file" rechts oben. Die Kopfzeile holt man sich am einfachsten aus einer anderen Datei.
-
@Jey-Cee sagte in Neue Dokumentation ins nächste Level heben:
Zu 1.: Dafür muss im entsprechenden Pfad auf Github eine neue Seite erstellt werden.
Das reicht allei e nicht, auch das Menü muss angepasst werden.
Habe gestern schon in einem anderen Thread einiges dszu geschrieben.Und vieles existiert bereits und ist im Moment "nur" nicht in die Struktur integriert.
Bin leider aus gesundheitlichen und dienstlichen Gründen nicht dazu gekommen, dass zu prüfen.
-
@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.