( persicsb | 2015. 11. 07., szo – 10:38 )

Ki tudja, ha a GetLofasz-nak van bármilyen mellékhatása, akkor azt dokumentálni kell. És *lehet* ilyen mellékhatása. Például ez egy lazy getter, első híváskor példányosít, más esetben pedig a cache-lt példányt adja vissza.
Vagy mondjuk az, hogy ez safe copy-t ad vissza, vagy éppen elérhetővé teszi a külvilág felé a belső állapotot egy módosítható formában.
Ez mind olyan dolog, ami nem fejezhető ki jól a metódus nevével, és dokumentálni kell, ha fennáll.
Dokumentálni metódus fejlécében mindig azt kell, amit a metódus szignatúrája önmagában nem fejez ki.