title: Pycharm docstring: code references and docstring inheritance
body: <p>I'm currently going through my project in Jetbrains Pycharm 2017.1.5, documenting all my python 3.6 classes and methods, and several things stand out to me about the docstring format.</p>
  
  <p>I want to link to other methods / functions / classes from some of the docstrings, but I cannot figure out how to do this. The documentation for <a href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#inline-internal-targets" rel="noreferrer">restructuredText</a> is very, very extensive, but it doesn't say anything about referencing other docstrings with <em>Pycharm</em>. In fact, the vast majority of the snippets from that page do not even work in Pycharm. (Why is that?)</p>
  
  <p>I've managed to find that you can use <code>:class:`&lt;class_name&gt;`</code> to reference a class, but <code>:class:`&lt;class.method&gt;`</code>does not work, and similarly named constructs like <code>:func:`&lt;func_name&gt;`</code> do not create a hyperlink. I've also seen <code>:ref:`&lt;name&gt;`</code> come up, but that one doesn't work either.</p>
  
  <p>(I would switch to <a href="http://epydoc.sourceforge.net/epytext.html" rel="noreferrer">Epytext</a> (it has everything I want, plus it's much simpler) in a heartbeat if not for this error: <code>You need configured Python 2 SDK to render Epydoc docstrings</code> in the Ctrl + Q frame.)</p>
  
  <p>It would also be extremely helpful if there was a way to inherit the docstring in subclasses / overridden methods. Pycharm does this automatically if you leave the docstring blank, which makes me think it is possible to do it manually. But, again, I can't find any information on it.</p>
  
  <p>It's turning out to be mind-blowingly complicated to do something so, so simple. So, any help will be appreciated!</p>