Changes between Initial Version and Version 1 of CommitMessageGuidelines


Ignore:
Timestamp:
05/26/08 15:36:04 (16 years ago)
Author:
Henrik Heimbuerger
Comment:

Intermediate save

Legend:

Unmodified
Added
Removed
Modified
  • CommitMessageGuidelines

    v1 v1  
     1= Guidelines für !JaCaVi Commit Messages =
     2
     3== Allgemeines ==
     4
     5 * Alle Commits werden in englischer Sprache dokumentiert.
     6 * Jeder Commit sollte mindestens einem Ticket zugeordnet werden können. (Im Zweifelsfall fehlt einfach ein Ticket.) Idealerweise beschränkt sich ein Commit auch auf genau ein Ticket. Dies kann jedoch nicht immer eingehalten werden.
     7 * Die Commit Messages sollten einen klaren Überblick über die durchgeführten Änderungen geben, ohne in die Quellen/Diffs sehen zu müssen. Argumentationen warum die eine statt einer anderen Implementierung gewählt wurde, sollten eher als Comment dem zugehörigen Ticket angefügt werden. Generell gilt: so kurz wie möglich, so lang wie nötig.
     8
     9== Format ==
     10
     11{{{
     12#!text/plain
     13[<Ticket-Referenzen>] <Kurzzusammenfassung>
     14
     15<Ausführlichere Beschreibung>
     16}}}
     17
     18Auf die Ticket-Referenzen geht der folgende Abschnitt genauer ein.
     19
     20Die Kurzzusammenfassung besteht idealerweise aus genau einem Satz.
     21
     22Die zweite Zeile sollte wohl freigelassen werden. Ansonsten hat mir TortoiseSVN im Log (manchmal!) die Beschreibung mit der 'Vorschau' angezeigt.
     23
     24== Ticket-Referenzen ==
     25
     26Sollte mindestens einen Verweis auf ein Ticket enthalten (in der Form #1).
     27
     28Vorschläge:
     29 * [Fix for ticket #1]
     30 * [Partial fix for ticket #1]
     31 * [Fix for ticket #1, partial fix for ticket #2]
     32 * [In preparation of #1]
     33
     34Oder wenn es gar nicht anders geht (momentan wird nicht sichergestellt, dass mindestens ein Ticket referenziert wird):
     35 * [Not related to any ticket]
     36
     37== Beispiele ==
     38
     39{{{
     40[Fix for ticket #1, in preparation of #2] When a document or folder is deleted, links pointing to these documents are now removed.
     41
     42These deletions cause modifications of the respective documents and may therefore trigger packages to be marked as 'modified' other than the ones the documents/folders are deleted from.
     43
     44The convenience function findDocumentsLinkingTo() has been updated and now supports folders as well as documents as link targets.
     45
     46The message box shown when removing documents/folders has been updated to reflect the new behaviour (related to ticket #3).
     47}}}
     48
     49== Tipps ==
     50{{{
     51#!html
     52<span style="color: white">Geheimtipp</span>
     53}}}