It seems incredibly backwards to me that we wouldn't document something which _throws an exception_.