> context has been omitted for the sake of brevity
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't want to reverse engineer someone's brain every time I read code. 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's going to be really hard to follow the code.
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't want to reverse engineer someone's brain every time I read code. 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's going to be really hard to follow the code.