Anforderung an Patches und Commits ergaenzt
Commitmessages sollten einem halbwegs konsistenten Stil folgen.
Aenderungen von Inhalt und Whitespace sollten getrennt sein.
Change-Id: Ia68aa734561dc4159ec9b0920accad22d6e2e604
diff --git a/doc/wiz/mudlib-codestyle b/doc/wiz/mudlib-codestyle
index bfaae3a..6e0ad09 100644
--- a/doc/wiz/mudlib-codestyle
+++ b/doc/wiz/mudlib-codestyle
@@ -4,6 +4,8 @@
* Einrueckungen per Leerzeichen, nicht Tabs
* Einrueckung von 2 Leerzeichen pro Ebene
* praegnante und viele Kommentare
+* Kommentare sollen nicht (nur) beschreiben, was der Code tut, sondern
+ vor allem, was er tun soll und warum.
* keine lambdas
* Bei inline-closures die function-Syntax statt der (: :)-Syntax verwenden.
* else, else if in eine eigene Zeile
@@ -17,6 +19,20 @@
* Pfade, die absolut sind, sollen auch mit / beginnen, z.B.
inherit "/std/thing", nicht inherit "std/thing"
+Commits und Patches
+* Bei Patches bitte keine inhaltlichen Aenderungen mit jeder Menge
+ Whitespace-Aenderungen vermischen.
+* Pro Patch bitte nur eine inhaltliche Aenderungen einschliessen
+* Jeder Commit muss eine aussagekraeftige Commitmeldung haben und
+ folgendem Style entsprechen:
+ * Die erste Zeile ist der Betreff
+ Dieser beschreibt in 50-60 Zeichen, worum es geht
+ * Eine leere Zeile
+ * Beliebig viele Zeilen mit Beschreibung von max. 70 Zeichen Laenge
+ Dieser Text sollte erklaeren, Warum und Wieso der Aenderung.
+* Commits sollten sich sauber auf die aktuelle Spitze vom master-Zweig
+ anwenden lassen. (Bzw. zumindest nicht schon Wochen alt sein.)
+
Benennung von Properties:
* der interne Name von Properties in der Basis-Mudlib beginnt immer mit
"p_lib_". Niemand sonst sollte Properties mit diesem Praefix erstellen.