何时应记录例外情况?

假设以下代码段:

public function foo() 
{
    return $this->dependency->bar();
}

如果 dependency::bar() 已知会引发异常,但 foo() foo() 有一个 @throws 进入docblock?或者这应该是隐含的?phpdoc文档对此有些模糊。

假设 dependency 基于接口注入;该接口文件应说明该方法 可以 引发指定的异常。

异常应该由调用代码处理还是与情况无关?

语义:)