title: Documenting exceptions that can happen in other functions in python docstrings
body: <p>In Python, should we document in the docstrings exceptions that can be raised in other functions/classes besides the ones that are raised in the body of current function/method?</p>
  
  <p>Obs.: I'm considering the Google Python docstring style <a href="https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_google.html" rel="nofollow noreferrer">https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_google.html</a></p>
  
  <p>It has been a long time since I don't play with Java, but there you would explicitly say what kind of exceptions that your method could raise with the "throws" keyword.</p>
  
  <p>Eg.:</p>
  
  <pre><code>class MyException(Exception):
      pass
  
  class A(object):
      def foo(self):
         """This class does foo
  
         Returns:
             Int: The number of foo.
  
         Raises:
              MyException - In case something happen
         """
         if True:
             raise MyException
         return 0
  
  class B(object):
      def __init__(self):
          self._a = A()
  
      def bar(self):
          """This class does bar
          Returns:
              Int: number of bar
          Raises:
               MyException ????? Should this be here?
          """
  
          return self._a.foo()
  </code></pre>