[Javalist] tifyty szerda

[Gábor Lipták]

Abban egyetértek, hogy a jó elnevezések, rövid, jól tagolt kód kommentekkel
nem pótolható. Többet ér mint a komment. Ugyanakkor szerintem egy jó
javadoc példákkal, ami leírja a választ a "miértekre" nagyon hasznos.
Szóval a hogyan működik a kód, az jó ha a kódból derül ki könnyen. A miért
az nem derül ki. Példa: van egy újrapróbálkozás valamilyen osztályba
beépítve. Néhány év múlva egy fölösleges kódnak tűnik, ha nincs odaírva,
hogy "xy tűzfalbeállítással a kapcsolat bezáródhat, ezért újra próbáljuk"
stb. Vagy egy másik példa: van egy Visitor, és beleírjuk, hogy azért van,
mert az objektumokat nem akarjuk memóriában tartani mind, mert a múltban
kiderült, hogy OutOfMemoryError jött miatta. Szóval szerintem a jó komment
olyat mond legtöbbször, ami a kódban szigorúan nincs benne.

A változáskövetéses kommentekről annyi a véleményem, hogy attól függ, hogy
tud e a csapat normálisan mergelni meg branchelni, vagy nem. Ha lokális
másolással és importtal branchelnek, akkor nyilván elveszlik a SVN history,
és akkor kín megtalálni ki, miért csinált, mit. Ekkor segít. De szerintem
hasznosabb felügyelni a branchelést (és utasítani a programozót, hogy akkor
lehet mégegyszer jobban) mint ilyen kommenteket tenni.


2012. december 6. 9:05 Molnár Miklós írta, <timortinj at freemail.hu>:

> Na és mi a vélemény(ed) az olyan kommentekről, ami (a) teammunka miatt (ki
> módosított mit) (b) változásmanagement részeként került bele időpont
> megjelőlésével.****
>
> Java-tól függetlenül általánosan nézve a kérdéskört.****
>
> ** **
>
> *From:* javalist-bounces at lists.javaforum.hu [mailto:
> javalist-bounces at lists.javaforum.hu] *On Behalf Of *Peter Verhas
> *Sent:* Wednesday, December 05, 2012 1:04 PM
> *To:* Java lista
> *Subject:* Re: [Javalist] tifyty szerda****
>
> ** **
>
> Ez volt az:****
>
> ** **
>
> http://tifyty.wordpress.com/2012/10/31/commenting-is-evil/****
>
> ** **
>
> --
> Verhás Péter
> peter at verhas.com
> +36(30)9306805
> skype: verhas****
>
> ** **
>
>
>
> ****
>
> ** **
>
> On 2012.12.05., at 13:01, Gábor Lipták <gabor.liptak at gmail.com> wrote:****
>
>
>
> ****
>
> És? Szabad? Nekem ez a cikk nem volt meg :)****
>
> ** **
>
> 2012. december 5. 11:36 Peter Verhas írta, <peter at verhas.com>:
>
> ****
>
> Hogy szabad-e a metódus belsejébe kommentet írni.****
>
> --
> Verhás Péter
> peter at verhas.com
> +36(30)9306805
> skype: verhas****
>
> ** **
>
>
>
> ****
>
> ** **
>
> On 2012.12.05., at 10:03, Gábor Lipták <gabor.liptak at gmail.com> wrote:****
>
>
>
> ****
>
> Példa a megváltozott véleményre?****
>
> ** **
>
> ** **
>
> _______________________________________________
> Javalist mailing list
> Javalist at lists.javaforum.hu
> http://lists.javaforum.hu/mailman/listinfo/javalist
>
>
--------- következő rész ---------
Egy csatolt HTML állomány át lett konvertálva...
URL: <http://lists.javaforum.hu/pipermail/javalist/attachments/20121206/e05bab5c/attachment.html>