> but some documentation as to say what could possibly be thrown from method > a,b,c is I guess what > I was looking and/or advocating for.
I can see your point, and in this case since we weren't actually adding it to the method signature it wouldn't have caused any issues for consumers. But writing it "officially" as a `@throws` seems to me a bit like indicating that a method that accesses a list somewhere in the implementation could throw an `IndexOutOfBoundsException`. Also, I would be more tempted to add a note about this kind of possibility if we felt that there was something users could feasibly do in that case, e.g. "Implementation note: may throw a TransformParallelException. This can occur when X, Y and Z. Callers can catch this exception and do A, B and C to handle this." Thanks for the squash'n'rebase! --- Reply to this email directly or view it on GitHub: https://github.com/jclouds/jclouds/pull/419#issuecomment-47022429
