Dokumentace kodu

[Michal Gregor]

Ja jsem psal o doporuceni omezit mnozstvi komentaru ne o jejich zakazu.
V te knize se jen je doporucuje komentare nahradit lepsim pojemnovanim 
nazvu promennych nebo funkci. Pro slozitejsi algoritmy a rozhrani 
samozrejme komentare patri.

Napriklad v tomhle se nikdo nevyzna, ani autor:
x = z * 1,21;

Ale kdyz to prepisu:
CenaVcetneDPH = CenaBezDPH * SazbaDPH;

Tak k tomu zadny komentar neni treba.

Michal Gregor




Dne 19.6.2015 v 8:41 bubnikv . napsal(a):
>  >  No v jedne knizce se pise:
>  >  "Dobre napsany kod nepotrebuje komentare."
>
> S dovolením, považuji se za dost tolerantního člověka, ale z podobných
> výroků mám fyzickou potřebu zvracet. A to proto, že jsem v jedné
> nejmenované německé nadnárodní společnosti zažil stejnou kulturu. Daná
> společnost se vzhlédla v "Agile programmierung". Tedy "Agile
> programmierug" metoda byla této pobočce velké německé nadnárodní
> společnosti vnucena externí SW vývojářskou firmou, jejíž hlavní úloha je
> jistě co nejdéle udržet obchodní vztahy. Agile programmierung
> náboženství hlásá spoustu podivných věcí, mimo jiné tu o nulové potřebě
> komentářů.
>
> Po 13 letech praxe a pozice SW architekta středního týmu jsem poprvé v
> životě nebyl schopen zapracovat se do kódu mimo jiné proto, že nebyl
> dokumentován a že se mi pod rukama velmi agilně měnil.
>
> Vojta Bubník
>
>
>
> _______________________________________________
> HW-list mailing list  -  sponsored by www.HW.cz
> Hw-list na list.hw.cz
> http://list.hw.cz/mailman/listinfo/hw-list
>