&gt; context has been omitted for the sake of brevity<p>Such omissions should be forbidden. Writing down the context in comments and in any other ways available should be a minimum requirement for any new code written. I do enjoy a good puzzle once in a while, but I don&#x27;t want to reverse engineer someone&#x27;s brain <i>every time I read code</i>. We should really focus more on helping other people understand the code we write. Some tools can help, but if the original author keeps most of the information to himself it&#x27;s going to be really hard to follow the code.