what self-documenting formula reinstate good documented code?


i have co-worker insists formula doesn't need comments, it's "self documenting."



i've reviewed code, while it's clearer formula i've seen others produce, i still remonstrate self-documenting formula finish useful good commented documented code.



help me know his indicate view.




  • what self documenting code

  • can unequivocally reinstate good commented documented code

  • are there situations where it's improved good documented commented code

  • are there examples where formula can't presumably self-documenting but comments



maybe it's only possess limitations, nonetheless i don't good practice.



this meant an justification - greatfully don't move adult reasons since good commented documented formula high priority - there resources arrangement this, nonetheless aren't convincing peer. i trust i need some-more entirely know outlook remonstrate otherwise. start new doubt must, nonetheless don't remonstrate here.



wow, discerning response! greatfully review existent answers yield comments answers rather supplement new answers, unless your answer unequivocally roughly opposite each answer here.



also, those arguing opposing self documenting formula -this essentially assistance me know outlook (ie, certain aspects) self-documenting formula evangelists. i design others downvote we don't stay topic.



Comments

Popular posts from this blog

list macos calm editors formula editors

how hibernate @any-related annotations?

why does floated <input> control floated component slip over too distant right ie7, nonetheless firefox?