Maybe you should add a sentence here that directs users to the `binom_conf_interval` docstrings for a detailed description of what these intervals mean?  When I first looked at it, I thought you hadn't documented that.  I see that the link is below, but if someone reads this over without background info, they won't necessarily understand that that's where they should go for the background needed to understand.