PyCharm and reStructuredText (Sphinx) documentation popups
<p>Let's imagine, I want to see a docstring popup for one simple method in <strong>PyCharm</strong> 4.5 Community Edition (tried also in 5.0).</p>

<p>I wrote down these docstrings in both <em>epytext</em> syntax (Epydoc generator is unsupported since 2008 and works only for Python2) and <em>reStructuredText</em> syntax (which is used by Sphinx - actively supported generator, used for offical python docs)</p>

<p>The epytext one works in PyCharm documentation popups perfectly</p>

<p><a href="http://i.stack.imgur.com/xTJbX.png" rel="nofollow">PyCharm works with epytext Screenshot</a></p>

<p>But the reStructuredText one doesn't show any parameters at all!</p>

<p><a href="http://i.stack.imgur.com/8lD8l.png" rel="nofollow">PyCharm fails with reStructuredText Screenshot</a></p>

<p>Trying to handle this with PyCharm settings, reading the PyCharm helps, searching through the PyCharm bugtracker and using Google couldn't help me to find the reason why these docstring popups in PyCharm don't work correctly with community-recommended docstring markup language.</p>

<p>Is this because of low demand of the feature? Perhaps, is there some useful alternatives to view the modern documentation markup inside PyCharm or even another IDE? I also need to be able to generate HTML pretty formatted docpages.</p>

<p>I've found <a href="http://stackoverflow.com/questions/31796481/documenting-python-parameters-in-docstring-using-pycharm">another topic</a> here, related to the same issue, but it is still unanswered since previous year. So, I'm guessing what's wrong with my desires to view modern documentation inside modern IDE.</p>

<p>Here are my code examples</p>

<pre><code>def find_links(self, issue, link_type):
    """

    Find all issues linked with C{issue} with C{link_type}.

    @param issue: Issue key
    @type issue: str
    @param link_type: Accepts either Type Name (like 'Child') or Link Description (like 'child of')
    @type link_type: str
    @return: Keys of found issues
    @rtype: list

    """
    result_keys = []
    link_list = self.get_link_list(issue)
    for link in link_list:
        ... # omitted
    return result_keys

def test_sphinx_docs_method(self, issue, link_type):
    """

    Find all issues linked with *issue* with *link_type*.

    :param issue: Issue key
    :type issue: str
    :param link_type: Accepts either Type Name (like 'Child') or Link Description (like 'child of')
    :type link_type: str
    :return: Keys of found issues
    :rtype: list

    """
    result_keys = []
    link_list = self.get_link_list(issue)
    for link in link_list:
        ... # omitted
    return result_keys
</code></pre>

<p>I do not know if this feature present only in recent PyCharm versions so what version do you have? In my PyCharm CE 2016.2.2 it looks like on the screenshot.</p>

<p><a href="http://i.stack.imgur.com/15b93.png" rel="nofollow"><img src="http://i.stack.imgur.com/15b93.png" alt="enter image description here"></a></p>

<p>Check Preferences > Editor > General > Code Completion, to be sure option "Autopop documentation" is enabled.</p>

<p>Good luck!</p>

python pycharm python-sphinx epydoc