Boolean parameters to API functions considered harmful.
When you have an API which takes a boolean parameter which chooses between two behaviors, just make two API functions, and put the behavior in the function name! See how much clearer these APIs become if we do this?
Source: jlebar.com