Śmietnik w źródłach

Po dłuższej przerwie wróciłem do kodowania w C. I powiem tyle, może to będzie najmądrzejsze zdanie, jakie padnie na tym blogu: po pierwsze dokumentacja, po drugie dokumentacja, etc. C nie jest językiem bardzo skomplikowanym, jednak wskaźniki, tablice, pamięć mogą w pewnym momencie narobić sporo bałaganu w źródłach.
Kiedy spojrzałem na Kodera świeżym okiem i zobaczyłem ten bajzel, to się przeraziłem. W pierwszym momencie nie wiedziałem o co chodzi :(. Dlaczego? Nazwy zmiennych, które nie wiadomo do czego służą, brak komentarzy itd. Zabrałem się za nowe funkcje już z silnym postanowieniem o tworzeniu kodu jak najbardziej zwartego i przejrzystego. Jeśli ma to być aplikacja open source wypadałoby, żeby osoba postronna też ją zrozumiała.