2015-04-27 3 views

ответ

2

Я бы сказал, сделайте это, только если они добавят полезную информацию читателям указанной UML-диаграммы.

Я бы сказал, что в любом случае любая документация должна быть написана только в том случае, если она полезна для ваших пользователей. Иначе это будет только в поисках других более важных вещей.

В случае строк документа вы должны обязательно написать метод docstring __hash__. И возможно сделать цитату в классе docstring.

+0

какой если я реализую __hash__ специальный способ. Полезно ли в этом случае включить его? – lmiguelvargasf

+1

Я бы сказал «нет». Поскольку ожидается, что хеш-функция хорошо себя ведет и имеет одну и ту же семантику на любом объекте. Я бы рассмотрел его как деталь реализации. – Governa

+0

Вы имеете в виду докстрину по деталям реализации? – lmiguelvargasf

Смежные вопросы