Manage documentation comments
Enable documentation comments
Press Ctrl+Alt+S to open the IDE settings and select
.In the Enter section, select or clear Insert documentation comment stub checkbox.
Then, expand the Smart Keys node and select Python. Use the Insert type placeholders in the documentation comment stub option as required.
If this checkbox is selected, PyCharm generates a documentation comment stub.
For the function comments, this stub contains the required tags (
@param
tags for each parameter declared in the signature, and@return
). Refer to Create documentation comments, JSDoc comments for details.
Disable documentation comments
To restrict creating documentation comments, press Ctrl+Alt+S to open the IDE settings and select Tools | Python Integrated Tools.
In the Docstrings area, select Plain from the Docstring format list. Click OK to save the changes.