brooks-lint decisions: why the code looks like this