DL

Inhalte ins Repo bringen

Statt Dateien per Mail oder Swisstransfer zu schicken, lädst du sie direkt ins Repo. Vorteil: alles ist sofort für mich sichtbar, versioniert, kein Verlust und keine doppelten Stände. Diese Anleitung führt dich durch das einmalige Setup mit GitHub Desktop und die drei Aktionen, die du im Alltag brauchst.

Der Alltag in einem Bild
1
Pull
Davids letzten Stand abholen
2
Bearbeiten
Profile, Bilder, Texte im Finder/Editor
3
Commit + Push
Änderungen ans Repo senden

Drei Aktionen, immer in dieser Reihenfolge. Das war es.

Einmalige Einrichtung

1 – App installieren

  1. desktop.github.com öffnen, Version für macOS oder Windows herunterladen, installieren
  2. Mit deinem GitHub-Account einloggen (der, dem die Heimatdesign-Organisation gehört)

2 – Repo lokal klonen

  1. File → Clone repository
  2. Tab URL wählen
  3. Repository-URL einfügen:
https://github.com/Heimatdesign/Guidetothewest.git
  1. Lokalen Speicherort wählen – ohne Leerzeichen oder Sonderzeichen, Vorschlag:
~/Documents/Guidetothewest/
  1. Clone

Damit hast du eine lokale Kopie des Repos auf deinem Rechner.

Drei Aktionen im Alltag

Aktion 1: Aktuellen Stand abholen (Pull)

Wann: bevor du an etwas arbeitest, am besten jedes Mal beim Start.

Warum: stellt sicher, dass du meine letzten Änderungen hast.

  1. App öffnen, Repo links in der Sidebar wählen
  2. Oben mittig: Fetch origin (heißt manchmal Pull origin, wenn es Änderungen gibt) klicken
  3. Falls Änderungen reinkommen: einfach automatisch übernehmen lassen

Aktion 2: Eigene Änderungen einreichen (Commit + Push)

Wann: wenn du Inhalte hinzugefügt oder geändert hast.

Warum: macht deine Änderungen für mich sichtbar.

  1. Im Finder oder Explorer im lokalen Repo-Ordner Dateien anlegen, kopieren, bearbeiten – ganz normal wie sonst auch
  2. Zurück in GitHub Desktop: links in der Sidebar siehst du die Liste der Änderungen, jede mit Häkchen
  3. Unten links eine kurze Commit-Message eintragen, was du gemacht hast. Beispiele:
    • „Profil Jan Kath hinzugefügt"
    • „Hero-Bild für KASCHKASCH"
    • „Texte für Folkwang Industrial Design ergänzt"
  4. Commit to main klicken
  5. Oben mittig: Push origin – fertig, deine Änderungen sind live im Repo

Aktion 3: Geschichte ansehen

Reiter History – alle Commits, was wann von wem geändert wurde.

Erste Aufgabe – Pilot-Profile

Wir wollen 6–10 Pilot-Profile sammeln, die wir im Mockup-Sprint und beim Soft Launch sofort nutzen können. Vorlage und Konvention liegen im Repo unter prototype/pilot-profiles/.

Pro Profil:

  1. Im Finder im lokalen Repo nach prototype/pilot-profiles/ navigieren
  2. Den Ordner _template/ kopieren und umbenennen, z. B. zu jan-kath/
  3. Die profile.md öffnen (in TextEdit, Obsidian oder einem beliebigen Editor) und ausfüllen
  4. Bilder in den Ordner ziehen (hero.jpg, projekt-1-werkstatt.jpg …)
  5. In GitHub Desktop: Commit-Message „Pilot-Profil Jan Kath hinzugefügt", Commit to main, Push origin

Konvention für Datei- und Ordnernamen: kleinbuchstaben mit Bindestrich, ohne Umlaute. Aus „Müller-Studio" wird mueller-studio.

Was du nicht versehentlich committen solltest

Im Finder werden manchmal versteckte Dateien angelegt:

Diese erscheinen ggf. in GitHub Desktop. Vor dem Commit das Häkchen entfernen – wir wollen nur unsere Inhalte committen. Ich habe eine technische Filterdatei (.gitignore) eingerichtet, die das langfristig automatisch ausfiltern soll.

Wenn etwas hängt

Bei Fragen zum Setup jederzeit anrufen. Bei Bedarf machen wir einen 15-Minuten-Call, damit das in einem Rutsch sitzt.