The cookbook is still pretty useful. I don't think it needs to cover the entire API. Not mentioning `throws` is fine. But since you wrote this already, we might as well add it. Its really just tiny problems that need to be improved.