Several years ago I found this Little Manual of API Design, and found it very useful. It discusses boolean arguments among other things. http://www4.in.tum.de/~blanchet/api-design.pdf