( kroozo | 2021. 12. 08., sze – 08:03 )

Clean code. Erre a részre a TL;DR az, hogy a kód legyen magától olvasható, öndokumentáló, illetve hogy ne legyenek side effektes dolgaid. Ebből eléggé következik, hogy nem kell kommentet írni, mert az annak a beismerése, hogy a kód nem dokumentálja jól önmagát. (És kommentet karbantartani szar, mert simán elfelejted. Ha ott helyben nem is, a file tetejéről már lehet, a valahol tök máshol beírt (ezzel itt nem foglalkozunk, mert hat fileal arrébb csinálja valami típusúakat meg szinte biztos, és nem segít a linter)

Ha valahova blokkzáró kommentet kell írni, akkor az a blokk túl hosszú, vagy túl sok minden van nestelve, kéne lássam ránézésre, hogy mi van egyben. Másik ilyen tipikus példa a "this does" jellegű kommentek, amikről szaglik, hogy na ezt ki kéne szervezni külön, és nevén nevezni.