One-line docstring should fit on one line with quotes FLK-D200
Documentation
a year ago
—
a year old
One-line docstring should fit on one line with quotes
97 @property
98 def epoch(self):
99 # type: () -> int
100 """101 An integer giving the version epoch of this Version instance
102 """
103 _epoch = self._version.epoch # type: int
Description
If a docstring fits in a single line (72 characters according to PEP8), it is recommended to have the quotes on the same line.
Bad practice
def foo():
"""
Runs bar and returns baz.
"""
baz = bar()
return baz
Recommended
def foo():
"""Runs bar and returns baz."""
baz = bar()
return baz