Правила документации



class Post:

"""На первой строке краткое описание объекта. После идёт пустая строка (это обязательно).



После идёт подробное объяснение. Кто он,

что он делает и какие параметры принимает.

Документировать можно в несколько абзацев.

Писать доки можно для всего: функции, класса, модуля.

Но если вы мне не доверяете, можете почитать PEP257,

там разработчики рассказывают, как объяснять код.

"""



#теория