Jak na uhlednější kód – podělte se o svoje tipy

Upozornění: Tohle vlákno je hodně staré a informace nemusí být platné pro současné Nette.
bazywalker
Člen | 5
+
0
-

Všem přeji krásný večer(ráno). Jsem takový perfekcionalist a snažím se, aby můj kód vypadál úhledně. Kód rozděluji na bloky(regiony) a následně okomentuji, co daný region obsahuje, ale když to potom rozbalím a kód ještě obsahuje anotaci, tak to vypadá opravdu příšerně. Jak to řešíte vy? Řešíte to vůbec nějak? :)

looky
Člen | 99
+
0
-
jiri.pudil
Nette Blogger | 1032
+
+3
-

Asi zkus být konkrétnější, v takhle obecné rovině si těžko dokážu představit, co tím chtěl básník říci a jak „příšerně“ ten kód vlastně vypadá :)

Ale dám ti aspoň obecnou odpověď, jak mít v codebase pořádek: kód rozděluji na třídy. Každá třída dělá jenom tu jednu věc, kterou dělat má, a je podle toho taky pojmenovaná a zařazená do jmenného prostoru. Obvykle pak už nemám potřebu psát nějaké obšírné komentáře, protože název třídy a její veřejné API jsou samopopisné.

llook
Člen | 407
+
+4
-

Nevymýšlej kolo a přečti si Čistý kód, to je nestárnoucí klasika na tohle téma: http://knihy.cpress.cz/cisty-kod.html