Neue Dokumentation ins nächste Level heben
-
Mal sehen wo ich dir weiterhelfen kann.
Zu 1.: Dafür muss im entsprechenden Pfad auf Github eine neue Seite erstellt werden.
Zu 2.: das passt am besten unter Tutorials.
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.
Zu 4.: Der Kopf und diese Hinweisboxen werden vom der Doku Seite interpretiert, das kennt der github editor nicht. Der Rest ist soweit ich das bisher gesehen habe reines Markdown und sollte von Github richtig interpretiert werden.
Zu 5.: Plugin sollte für GitHub nicht nötig sein, da ist das schon seitens Github implementiert.
Die von dir angesprochenen Punkte kann man in der Doku verbessern. Danke für dein Feedback.
Ich hoffe das du weiter machst und Hilfst die Doku weiter zu verbessern. Vieles kannst du direkt selbst verbessern in dem du unklare Passagen überarbeitest.
@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.
kein Support per PN! - Fragen im Forum stellen -
Benutzt das Voting rechts unten im Beitrag wenn er euch geholfen hat.
Das Forum freut sich über eine Spende. Benutzt dazu den Spendenbutton oben rechts. Danke!
der Installationsfixer: curl -fsL https://iobroker.net/fix.sh | bash - -
@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.
Persönlicher Support
Spenden -> paypal.me/J3YC33 -
@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? -
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. -
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
@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 -
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.
Hey! Du scheinst an dieser Unterhaltung interessiert zu sein, hast aber noch kein Konto.
Hast du es satt, bei jedem Besuch durch die gleichen Beiträge zu scrollen? Wenn du dich für ein Konto anmeldest, kommst du immer genau dorthin zurück, wo du zuvor warst, und kannst dich über neue Antworten benachrichtigen lassen (entweder per E-Mail oder Push-Benachrichtigung). Du kannst auch Lesezeichen speichern und Beiträge positiv bewerten, um anderen Community-Mitgliedern deine Wertschätzung zu zeigen.
Mit deinem Input könnte dieser Beitrag noch besser werden 💗
Registrieren Anmelden295
Online32.8k
Benutzer82.9k
Themen1.3m
Beiträge