Komentarze, opisy, zmiany nazw w/g konwencji

Uporządkowałem trochę kod.
Jeżeli zgadzacie się na zmiany to można tu zrobić merge'a.