Module-level docstring
Class-level docstring
Subclass docstring
Subclass method docstring
No one in their right mind would use this method.
Parameters:
- fuzzy (object) – bear state
- wuzzy (str) – query
Returns: “false”
Return type: str
Method-level docstring
This method has no legs, but at least the docstring does have a body.
Parameters:
- snozz (object) – relevant nose
- berries (str) – expected content name
Returns: 3, the magic number
Return type: int
Function-level docstring
Words, words, words.
fizz, buzz, foo, bar
>>> fizz = 'buzz'
>>> class Snork:
... pass
A literal example, but without the closing “Example” section: a = 3 b = object()
a markdown literal, explicitly python
a markdown literal, implicitly python
a markdown literal, explicitly javascript
Parameters:
- bar (object) – bar to foomangle
- baz (int) – number of times to foomangle
Returns: cat breath soup
Return type: bool