A lecture about the art of making code clean, primarily sourced by Robert C. Martin's Clean Code and more or less a short fly through said book.

1. Clean Code urice

2. • dobri programerji ne obstajajo!
• flamewars appreciated

3. Clean == pedantry?
• do_something vs. doSomething
• foo[‘bar’] vs. foo[ ‘bar’ ] vs. foo [ ‘bar’ ]
• if something { do_it } vs. if something
{
if something do_it()
vs. }
{
do_it()
}

4. Kaj je ‘clean’?
• elegantnost
• berljivost
• DRY+KISS+obvious

5. Zakaj?
• slaba koda vedno bo
• coding == reading
•b

7. • Poimenovanje entitet
• Izraznost funkcij
• One lang per doc
• Formatting
• Objects || data
• Errors

8. 1. Poimenovanje
• izrazen naravni jezik
• domensko izrazoslovje
• searchable!

9. 1. Poimenovanje - avoid
• hungarian notation (phnUsr)
• type ‘hinting’ (UserList)
• mental mapping
• puns/jokes/stupid-stuff (HolyHandGrenade)

10. 2. Funkcije
• almost functional programming
• single responsibility principle
• samo! en abstrakcijski nivo

11. 2. Funkcije
• malo argumentov
• brez flag argumentov!
• brez stranskih ucinkov

12. 3. Komentarji
• One Language Per Document!
• the good
• the bad
• the ugly

13. 3. Komentarji - bad
• don’t mumble
• neuporabni komentarji
• obvezni komentarji
• javadoc v privat kodi
• position markers

14. 3. Komentarji - good
• API javadoc
• razlaga namena
• warnings
• TODO

15. 3. Komentarji - ugly

16. 4. Formatting
• not the pedantry!
• vertical formatting
• horizontal formatting

17. 4. Formatting - vertical
• newspaper analogy
• breezy
• vertical density/distance
• top -> bottom

18. 4. Formatting -
horizontal
• short lines
• alignment je samo za assembler
• indentation

19. 4. Formatting - fin

20. 5. Objects || data
• abstract everything
• disguise internals
• brez seterjev in geterjev
• law of Demeter

21. 5. Data transfer objects
• brez metod
• vse je public
• work-around kjer ni named arguments
• cudne podatke abstrahiramo v znan objekt

22. 6. Error handling
• napaka je dogodek, ne stanje -> exceptions
• ne vracajmo null vrednosti
• errorje pohandlamo kjer jih lahko, ostali
nivoji naj se z njimi ne ukvarjajo