Kood on puhas kui see on lihtsasti mõistetav mitte ainult autori, vaid ka teiste arendajate poolt.
Kood keel, millega me lõpilikult väljendame nõudmisi. Me ei saa koodist kunagi lahti, sest kood kirjeldab nõudmiste detaile.
Nõudmiste kirjeldamine sellisel viisil, et masin saab neid täide viia on programmeerimine. Selline kirjeldamine on kodeerimine.
Koodi saab nimetada ilusaks, kui see tekitab tunde, et vastav programmeerimiskeel oli loodud selle probleemi lahendamiseks.
Tähendusrikkad nimed
Kasuta otsitavaid nimesid
Ühesõnalisi muutujanimesid saab kasutada AINULT kohalike muutjate korral lühikestes meetodites.
Muutuja nime pikkus peaks vastama skoobi suurusele.
Kindlasti, jadades ja ahelates võib kasutada lühikesi nimesid (i, j, k), sest nende skoop on väga väike ja teised nimed ei saa sellega konflikti minna.
Seda ainult põhjusel, et ühetähelised jadade nummberdajad on saanud traditsiooniks. Kuid kõikjal mujal on ühetäheliste nimeda kasutamine halb valik.
Meetodid peaksid omama tegusõna või tegusõna fraasi nagu postPayment, deletePage või save.
Andmete saajad, muutjad ja öeldised peaksid olema nimetatud oma tähenduse järgi ja eesliidestatud vastavalt get-, set- js is-.
Me tahame, et meie kood oleks kiiresti sirvitav, mitte ei vajaks põhjalikku analüüsi.
Me tahame kasutada populaarset ajakirjanduse mudelti, kus autor vastutab, et tema sõnum on selge, mitte akadeemilist mudelit, kus teaduri vastutada on uurimusest selle mõte ja tähtsus välja kaevata.
Lühemad nimed on üldiselt paremad kui pikad, senikaua kui nad on selged. Ära lisa nimedesse rohkem tähendust kui vajalik.
Nimed accountAddress ja customerAddress on ilusad Aadressi klassi meetodite nimed, kuid oleksid halvad nimed klassi jaoks. Aadress on ilus nimi klassi jaoks.