✅ Write small, focused functions – each should do one thing well.
✅ Avoid unnecessary abstractions – don’t create layers of factories, patterns, or inheritance just to look clever.
✅ Use simple data structures first – only reach for complex ones when you truly need them.
✅ Don’t prematurely optimize – clarity matters more than micro-performance tweaks in most cases.
✅ Prefer clear code over excessive comments – if it needs lots of explanation, it’s probably too complex.
✅ Avoid “magic” behavior – implicit or hidden logic makes code harder to read and debug.
✅ Make code easy to read – if a new developer can’t understand it quickly, it’s not simple enough.
isid KISS-põhimõtte kohta – räägin otse, ilma ilustamata:
Mis on KISS?
KISS = Keep It Simple, Stupid (või viisakamalt: Keep It Simple and Straightforward).
See on tarkvaraarenduse üks tähtsamaid põhimõtteid:
Ära tee asju keerulisemaks kui vaja.
Miks KISS oluline on?
- Lihtne kood on loetav – sina ja teised saate sellest hiljem aru.
- Lihtne kood on vähem vigadest tulvil – keerukus on peamine veaoht.
- Lihtne kood on kergem testida – väiksemad, sirgjoonelisemad moodulid on paremini katvad.
- Lihtne kood on lihtsam hooldada – iga kord, kui teed muudatusi, ei pea sa mõistatama, kuidas kogu asi töötab.
Kuidas praktikas KISS’i järgida?
- Kirjuta väiksed funktsioonid/meetodid – tee üks asi korraga (ja tee see hästi).
- Väldi üliabstraktset mustrite-mustrite-mustrite virvarri, kui pole reaalset vajadust. Näiteks ära tee “tehaseid tehase sees” ainult selleks, et kõlada targalt.
- Kasuta lihtsaid andmestruktuure, enne kui hakkad ehitama omaenda raamistikke või keerulisi hierarhiaid.
- Ära optimeeri enneaegselt – enamik koodi ei vaja “raketikiirust” ja keerukust, vaid stabiilsust ja selgust.
- Eelista selget koodi kommentaaridele – ära kirjuta keerulist koodi ja proovi seda siis kommentaaridega “päästa”.
- Väldi ülemäärast konfiguratsiooni ja “magic” käitumist – kui keegi teine ei saa aru, mis või kust toimub, on see liiga keeruline.
- Tee koodi lugemine lihtsaks – kui uus arendaja peab 20 minutit mõistatama, mis toimub, pole see KISS.