:::warning Please refer to the Wiki: https://collaborating.tuhh.de/cfg0846/research-topics-mat-tuhh/-/wikis/Getting-Started The instructions below are no longer updated. >[name=Fabian] ::: Im folgenden erkläre ich kurz, die Schritte je nach dem Vertrauensstatus, den ihr gegenüber dem Repository besitzt. * Standardmäßig besitzt ihr keinen Vertrauensstatus, was nicht böse gemeint ist, sondern nur bedeutet, dass ihr alle Veränderungen in eurem eigenen Namensraum vorbereiten müsst. In diesem Fall beantragt Zugang zum Repository (`request access`, oder folgt der Anleitung für non-`developer`s in der unteren hälfte. * Falls ihr als `Reporter`, `Developer`, `Maintainer` in dem Repository eingetragen wurdet, könnt ihr direkt Änderungen an dem Repository vornehmen (aus Gründen der Qualitätssicherung aber nicht überall). Folgt daher der Anleitung für `developer`! # Merge-Request für Developers This part is no longer kept up to date. Please refer to https://collaborating.tuhh.de/cfg0846/research-topics-mat-tuhh/-/wikis/Getting-Started for an updated version ## Versuche den folgenden Ablauf einzuhalten: `issue` -> `merge-request` -> Bearbeitung -> `mark-as-ready` -> `merge` ## Beispiel: * `Issue`: Du möchtest ein Thema anlegen oder hast einen Fehler entdeckt, ziehe eine Ticket (`Issue`) * `feature-branch`: Löse dein Problem, indem du den Fehler behebst * `merge-request`: Biete deine Lösung an, damit sie in den `dev`elopment Branch integriert werden kann (Inhaltliche Qualitätssicherung) * `merge to master`: Hier werden nur Inhalte/Lösungen veröffentlicht, die stabil sind und nochmals geprüft wurden (Technische Qualitätssicherung) ## Schrit für Schritt Anleitung 1. Issue erstellen (damit bringst du zum Ausdruck, dass du etwas verändern möchtest)   2. Beschreibung ausfüllen (was hast du vor? Ganz kurz.)   * Ordne das Pr * Wähle ein Passendes Label (z.B. `typo` oder `research-topic`). Siehe [hier](https://collaborating.tuhh.de/cfg0846/research-topics-mat-tuhh/-/labels) für eine vollständige Liste aller Labels 3. Erzeugung über **Create issue** abschließen  4. Merge request erzeugen (Bereite deinen Arbeitsbereich vor (`Branch`))    5. Gerne den voreingestellten Branch name nutzen, und nach `dev` (auch voreingestellt) mergen  5.1 Optional ein passendes Label auswählen (falls nicht schon beim Issue getan, für inhaltliche Beiträge/Korrekturen `research-topic` oder `typo`)   6. Jetzt auf dem Branch (im obigen Beispiel) `4-example-issue` lokal oder im Repo arbeiten. Am einfachsten geht dies über `Open in Web IDE`:  * Die Markdown Dateien für die Topics finden sich im Ordner `topics` (s.a. [Repository-Structure](https://collaborating.tuhh.de/cfg0846/research-topics-mat-tuhh/-/wikis/Repository-Structure))     * Alternativ im Repository zu der gewünschten Datei bzw. dem Ablageort navigieren, und sie über `edit` bearbeiten bzw. sie über +new file hinzufügen (hierfür muss jedoch der zuvor erzeugte Branch ausgewählt sein):  * du kannst deine Datei auch im Online-Markdown Editor [HedgeDoc](https://writemd.rz.tuhh.de/) bearbeiten und anschließend per copy&paste in das Repo kopieren 7. Nach einem Bearbeitungsschritt mit `Commit` die Bearbeitung speichern.  8. Kehre zum Merge request zurück:  9. Warte bis die Pipeline durchgelaufen ist   10. Schau dir in der Review App eine Webseitenvorschau an  9. Gib Bescheid, dass du fertig bist, oder arbeite weiter auf deinem Branch, s.o.   10. Sehr gut  Ein Maintainer, wird nun den Merge Request überprüfen. --- # Merge-Request für Non-Depelopers * Du bist auf der Webseite gewesen und hast in einem Research Topic einen Fehler gefunden? Merke dir den Namen des Themas   * Geh auf unser Webseitenprojekt https://collaborating.tuhh.de/research-topics-mat-tuhh und suche im Ordner **topics** nach der entsprechenden `.md` Datei (ersetze dabei einfach `html` durch `md`)  * Gefunden!  * Wähle die Datei aus, in der du etwas korrigieren willst und klick auf **Edit** * In Hintergrund erstellt GitLab danach einen "Fork" mit einem feature-branch. Ggf. bestätigen und den Fork anlegen lassen.  * Klicke auf   * Führe Korrekturen, Ergänzungen durch:  * Nutze die Vorschaufunktion (kann keine Formeln)  * Für Formeln kannst du wie zuvor HedgeDoc nnutzen.n * Fertig?  * Fertig? Dann beschreibe deine Veränderung kurz und klicke auf commit.    * Noch eine Description ergänzen und abschicken  * Ich als Maintainer des Repositories bekomme nun eine Benachrichtigung:  * Und entscheide mich die Veränderung zu übernehmen, oder mit dem Einreicher darüber zu diskutieren  ###### tags: `gitlab`, `tutorial`