PyCharm
 
2022.1
Shortcuts: Windows
Get PyCharm
You are viewing the documentation for an earlier version of PyCharm.
  1. Python
  2. Document source code
  3. Create documentation comments

Create documentation comments

Last modified: 10 December 2021

Creating documentation comments for Python functions

To create documentation comment for a Python function

  1. Place the caret after the declaration of a function you want to document.

  2. Type opening triple quotes, and press Enter, or Space.

  3. Add meaningful description of parameters and return values.

tip

Mind the following:

  • Generation of docstrings on pressing Space after typing opening triple quotes only works when the checkbox Insert pair quote is cleared in the page Smart Keys of the editor settings.

  • If you rename a parameter of a function, PyCharm will correspondingly update the tag in documentation comment.

To create documentation comment for a Python function using intention action

  1. Place the caret somewhere within the function you want to document.

  2. Press Alt+Enter to show the available intention actions.

  3. Choose Insert documentation string stub:

    Intention action: Insert documentation stub

    PyCharm generates documentation comment stub according to docstring format, selected in the Python Integrated Tools page.

Example of Python comment

Consider the following function:

def handle(self, myParam1, myParam2):

In the Python Integrated Tools page, select Epytext. Then type the opening triple quotes and press Enter or Space. PyCharm generates documentation comment stub:

'''
@param self:
@param myParam1:
@param myParam2:
@return:
'''

Then select reStructuredText, type the opening triple quotes and press Enter or Space. PyCharm generates documentation comment stub:

'''
:param self:
:param myParam1:
:param myParam2:
:return:
'''

See also

Procedures

Reference

External Links