Új hozzászólás Aktív témák

• #16029 Drizzt nagyúr opr #16028

  Új Válasz 2021-06-19 14:17:57 #16029

  Új hozzászólás

  Összes hozzászólása itt Válaszok az összes hozzászólására itt Válaszok erre a hozzászólásra

  Privát üzenet küldése

  

  Drizzt

  nagyúr

  válasz opr #16028 üzenetére

  Kimondottan ellejvallott, kiveve ha koddal, vagy valtozonevvel nem lehet valamit kifejezni. En akkor irok kommentet, ha az adott szandekot sehogy nem tudom kifejezni a program nyelvi elemeivel. Pelda: ha mondjuk valamit raneyesre esszerubb lenne 3 sorral lejjebb vinni, de van kozben valami olyan framework hivas, aminek a mellekhatasa miatt nem lehet atsorrendezni, akkor meger egy kommentet. Ha valamit ki tudsz fejezni maskepp elnevezett valtozoval, vagy fuggvennyel, akkor jobb azt tenni, mint kommentet irni. A magyarazat egyszeru: ha a kod valtozik, s emiatt a mellette levo komment is idejetmultta valik, akkor nagyon nagy esely van, hogy a kommentet elfelejtik update-elni. Ennek meg az a vege, hogy par honappal kesobb ha arra a reszre teved az ember, nem tudja, hogy a komment hazudik, vagy a kod arrol, hogy minek kellene tortennie. Masik jo pelda, amit erdemes kommentelni: nyilvanos API, foleg ha abbol konkretan API spec lesz generalva. De ha siman annyi egy komment celja, hogy leirja mit csinal egy fuggveny, akkor jo esellyel a fuggveny neve a rossz. Ha meg a fuggveny neve igy 3 oldal kene, hogy legyen, akkor jo esellyel az a fuggveny tul sok dolgot csinal es erdemesebb feldarabolni. Persze ellenpelda mindenre van, ezek csak ilyen altalanos okoskodasok.

  #16027btraven:
  Miért nem csinalsz inkább enum-ot?
  PL. WATER_FREQUENCY.HIGH = 1, WATER_FREQUENCY.LOW = 2.
  Vagy ha nem diszkrét az értékkészlet, akkor inkább nevezném WATER_PROPORTION-nek, s akkor százalékként értelmezett adatot írnék bele. Vagy WATER_RATIO.

Új hozzászólás Aktív témák