I tend to design stuff on paper with logical boxes and arrows, then add that as a large comment at the beginning of a complex section, then implement it without

I tend to design stuff on paper with logical boxes and arrows, then add that as a large comment at the beginning of a complex section, then implement it without any comments in the code. That way, the code is still readable but there is a reference above it. Just like you have in books on programming languages.