Was eine Entwicklungsumgebung am ersten Tag leisten muss
Ein neuer Entwickler kommt ins Team, sei es intern oder extern. Was er am ersten Tag erlebt, entscheidet, ob er in einer Woche produktiv ist oder nach drei Wochen noch immer mit Setup-Problemen kämpft. Fünf Punkte machen den Unterschied.
1. Repo klonen, Befehl, läuft
Im Idealfall sind es genau drei Schritte: Repo klonen, Befehl ausführen, lokale Umgebung läuft. Egal ob Docker, Devcontainer oder ein klassisches Setup-Script. Wer mehr braucht, hat schon verloren.
Das ist nicht trivial, aber machbar, wenn das Team einmal Disziplin in Setup-Doku investiert. Diese Investition zahlt sich bei jedem neuen Entwickler aus, intern wie extern.
2. Seed-Daten, die Sinn ergeben
Eine leere Datenbank hilft niemandem. Seed-Daten, die typische Fälle abbilden (ein Kunde, eine Bestellung, ein Mitarbeiter, ein Dokument), erlauben sofort sinnvolles Arbeiten am UI. Wer keine Seed-Daten pflegt, zwingt jeden neuen Entwickler, sie selbst zusammenzusuchen.
Seed-Daten sind nicht für die Tests, sondern für die Entwickler. Tests bekommen ihre eigenen Fixtures.
3. Geheimnisse, die nicht im Repo liegen, aber dokumentiert sind
API-Keys, OAuth-Credentials, Anbindungs-Tokens. Sie gehören nicht ins Repo, aber sie müssen schnell beschaffbar sein. Eine Datei SECRETS.md, die erklärt, welche Variablen es gibt, wofür sie sind und wo der jeweils aktuelle Wert herkommt, spart Stunden.
Idealerweise gibt es einen Test-Account, mit dem ein neuer Entwickler ohne Sicherheits-Risiko arbeiten kann.
4. Funktionierende Tests vom ersten Tag
npm test oder mvn test muss am ersten Tag durchlaufen. Wenn die Tests rot sind, weil die Datenbank fehlt oder ein Service nicht erreichbar ist, hat der neue Entwickler keinen Vertrauensanker. Er weiß nicht, ob seine Änderungen etwas kaputtmachen.
Tests, die out-of-the-box laufen, sind ein Geschenk. Sie entstehen nicht zufällig, sondern weil jemand sie gepflegt hat.
5. Eine Person, die fragbar ist
Auch das beste Setup hat Lücken. Wenn ein neuer Entwickler eine Frage hat und drei Tage auf Antwort wartet, blockiert das das gesamte Onboarding. Eine benannte Person mit klarer Erreichbarkeit für die ersten zwei Wochen löst dieses Problem zuverlässig.
Fazit
Eine gute Entwicklungsumgebung ist Investition, kein Kostenfaktor. Sie verkürzt jedes Onboarding um Wochen und macht externe Verstärkung erst praktisch nutzbar. Wer Sparring sucht, wie das im eigenen Projekt aussehen kann, kann mich ansprechen.