[g11n-pl-discuss] Komentarze w SVN

[Michal Pryc]

Michal Nowak wrote:
> Witajcie,
> 
> Prosilem tyle razy zeby komentarze do waszych commitow, byly opisowe i
> oddawaly zmiany
> jakie wprowadzacie. Moze wam sie to wydawac glupie, ale pamietajmy
> jestesmy projektem
> opensource. Z doswiadczenia z poprzednich projektow wiem, ze duzo ludzi
> przychodzi jak
> i odchodzi. W nastepstwie tych zmian w "kadrach" nie mozemy sie dokopac
> do tego kto,
> co, gdzie, jak i z kim.
> 
> Odpowiednie komentarze znacznie ulatwily by zycie jak i pomogly w
> tworzeniu statystyk,
> ktore planuje wprowadzic. Pewnego dnia rozrosniemy sie i bedzie to
> stanowilo problem
> niesamowity, chciablym tego poprostu uniknac.
> 
> Pomijam juz fakt ze komentarze typu "jeszcze jeden i weekendzik,
> jazda!!!" brzmia
> smiesznie/glupio, i rujnuja nam reputacje.

+1
Proponuje wprowadzic rozwiazanie, ktore jest sprawdzone dla projektu
spec-files w jds, otoz sklada sie z 2 rzeczy:

1. Format logow w svn:
YYYY-MM-DD Imie Nazwisko <adres.mailowy (a] serwer.pl>

	* sciezka/do/pliku/plik.xml: Co zostalo zmienione.
	* sciezka/do/pliku2/pli.htm: Opis, co zostalo zmienione.

YYYY-MM-DD Imie2 Nazwisko2 <adres2 (a] serwer2.pl>

	* sciezka/do/pliku/plik.odp: Opis zgadzajacy sie z wpisem do Chengelog.


2. ChangeLog
Plik, ktory trzeba uzupelnic i commitowac wraz z innymi rzeczami na SVN,
w ktorym znajduje sie kopia wpisu do logow SVN.
(podobny do tego z
http://src.opensolaris.org/source/xref/jds/spec-files/trunk/ChangeLog):

Zmniejszy sie ilosc niepotrzebnych commitow, wprowadzi lad, oraz ulatwi
wyszukiwanie zmian w poszczegolnych plikach.

-- 
Michal Pryc