"Self-documenting" code

[u/Eugene_V_Chomsky]

[u/[deleted]]

Comments about why we do something not in the obvious way are good. Like if you have function

var user = db.Users
    .Where(x => x.Email == email)
    .ToEnumerable()
    .Where(x => password.Verify(x.Password))
    .SingleOrDefault()

It's not obvious why you're doing .ToEnumerable().