Skolelinux SVN Richtlinien

SVN speichert alle Projektdateien und all die Änderungen, die an diesen Dateien durchgeführt wurden. Die Möglichkeiten sind endlos: Wir können Änderungen zurückverfolgen, rückgängig machen, die Dateien zu einem bestimmten Datum zurückerhalten und vieles mehr.
SVN lässt viele Entwickler am gleichen Projekt zusammenarbeiten und sogar zur selben Zeit an der gleichen Datei.
SVN meldet uns:
- Was wurde geändert;
- Wann wurde geändert;
- Wer hat geändert, und;
- Warum wurde geändert.

Vermeiden Sie SVN Konflikte indem Sie oft svn update eingeben. Je länger es dauert, bevor Sie aktuakisieren, desto schwieriger wird es für SVN, ihre Änderungen mit denen anderer Entwickler zusammenzufügen developers.

Fangen Sie nicht an, an etwas grossem zu arbeiten, ohne es anderen Entwicklern mitzuteilen. Nichts ist irritierender, als zu entdecken, dass eine andere Person lange an der gleichen Aufgabe gearbeitet haben.

Alle Veränderungen im SVN können zurückgenommen werden. Trotzdem, wenn Sie fehlerhaften Code bestätigen (commit) wird dieser automatisch an hunderte von Skolelinux Servers verschickt und wir haben Schwierigkeiten.
Geben Sie svn update ein, bevor Sie bestätigen um sicher zu sein, dass ihre Datei aktuell ist. Anderenfalls riskieren Sie. die Veränderungen, die andere bereits eingegeben haben, zu überschreiben.
svn status ist eine einfache Möglichkeit sich zu versichern, dass man die richtige Datei committed.
Prüfen Sie die Veränderungen mit svn diff bevor Sie committen. Dies ist besonders wichtig bei 'live code', welcher automatisch zum APT Repository oder zur Haupt Internetseite kopiert wird.
Wenn Sie ihren code nicht verstehen, diskutieren Sie ihn mit anderen Entwicklern im IRC oder auf der Mailing Liste.
&Uunl;berlegen Sie, ob es nicht besserist, einen neuen entwicklungszweig aufzumachen, wenn Sie mit code experimentieren wollen.

Committen Sie immer, wenn Sie Angst haben, ihre årbeit zu verlieren.
Immer sollten Sie committen, wenn Sie etwas fertiggestellt haben, warten Sie nicht auf den nächsten Tag.
Wenn mehr als ein Entwickler an der gleichen Datei arbeiten, vermeiden Sie Konflikte wenn Sie oft commiten.

Mischen Sie nicht unzusammenhängende Verbesserungen mit dem gleichen commit.
Einzelne commits machen es leichter, Änderungen zurükzuverfolgen und falls notwendig zurückzunehmen.
Wenn eine einzige Verbesserung mehrere Dateien betrifft, dann committen Sie bitte alle Dateien gleichzeitig.

Stellen Sie sicher, dass Sie mitteilen warum Sie die Veränderungen vorgenommen haben. (SVN weiss immer wer wann und was geändert hat.)
Schreiben Sie die Log-Mitteilungen in englisch, es sei denn Sie arbeiten an lkalen Webseiten oder an Übersetzumngen.
Auch wenn die Veränderung wirklich unbedeutend ist, denken Sie darüber nach, trotzdem etwas wichtiges mitzuteilen. Kurze Mitteilungen wie 'typo' oder 'formatting' sind perfekt, wenn das alles war, was Sie geändert haben.

Beispiele:

Schlechtes Log	Gutes Log
asdfff	Fixed bug #123 by renaming magik() to magic().
updated	Updated magic() with a new transmogrification spell.
more stuff in pci.lst	Added PCI IDs for recent Intel network cards.