Should exceptions be documented on interfaces, or only on implementations? I've never been sure, and I've heard arguments both ways.

I guess you could also argue that some of the content in the summary tag is implementation specific.

In this case I'm leaning towards a "yes". BrokerUnreachableException is something I can see mock implementations throwing.

@adamralph what would Liskov say? :) I suspect yes as it is very much something you'd have to account for in making any implementation "replacable" without changes to the consuming code. That said specifying exactly what exceptions should be allowable for any one implementation isn't always easy to do up front.

I agree that the summary comment is implementation specific in this case it depends on the implementation of IEndpointResolver.

@kjnilsson good point. I guess, from that point of view, the exception docs can be considered part of the interface definition, requiring that every implementation behaves that way. The concrete way to do that would be something like checked exceptions in Java, but that is its own can of worms. :-)

I agree that the summary comment is implementation specific in this case it depends on the implementation of IEndpointResolver.

Do you think it's worth changing the comment?

Yes it should probably be changed.

I raised #332