title: Python Docstring: raise vs. raises
body: <p>I use the PyCharm IDE which assists with crafting PEP0257-compliant docstrings. It provides two attributes I don't entirely understand the distinction/use between:</p>
  
  <ul>
  <li><code>:raise Exception: exception explanation here</code></li>
  <li><code>:raises Exception: exception explanation here</code></li>
  </ul>
  
  <p>When would I use <code>raise</code> as opposes to <code>raises</code> in my docstring? Specifically, if a class required an argument that was not provided and raises a <code>TypeError</code>, which should be used to document that?</p>