(it: EnvironmentedProc.rb @ b524418, lines 78 ‒ 97)
When a particular portion of code is complex or difficult enough to understand, I find it advisable to go overboard on commentary and explanation. By swamping one or two lines of functionality with twenty lines of explanation, we visually convey to the reader that “we know this is complex, and we’re going to do our damnedest to help you understand it.” Before they even begin to read the commentary or associated code, we can ease their mind by dispersing the smallest amount of code possible amongst the largest amount of explanation we can write.
L or F like
Show and tell for designers
What are you working on? Dribbble is a community of designers sharing screenshots of their work, process, and projects.
Copyright © 2009–2017 Dribbble LLC. All screenshots © their respective owners. Shipped from Salem, Mass. USA.