Note to non-believers. These two screen shots show why code written in an outliner can be fully documented in place without affecting readability. 

Screen shot #1 -- comment at top of function is expanded revealing a narrative for why this complex bit of code exists. 

Screen shot #2 -- the comment at the top is collapsed. All you can see is that there are change notes at the top, only read them when you want to see what's there.