Задать вопрос
rstJkee
@rstJkee

Нужно ли документировать классы python?

Документируют ли тру питонисты классы и если да, то через docstring, по стандарту?
  • Вопрос задан
  • 87 просмотров
Подписаться 1 Простой Комментировать
Помогут разобраться в теме Все курсы
  • Яндекс Практикум
    Инженер по тестированию
    5 месяцев
    Далее
  • Нетология
    Инженер по тестированию
    8 месяцев
    Далее
  • Stepik
    "Поколение Python": курс для начинающих
    1 неделя
    Далее
Решения вопроса 1
Tomio
@Tomio
backend developer (python, php)
Работая в команде у вас не будет возможности не документировать классы, а так же функции и модули. Потому что:
1. Ваш код просто не пройдёт проверку по flake8 и ваш пайплайн в системе контроля версий упадет на этапе синтаксического анализа кода.
2. Это просто уважение к коллегам, которые будут работать с вашим кодом. КОмментарии намного облегчат им жизнь, да и вы вспомните что делает тот или иной класс или функция, если вернетесь к ним через какое-то время.

Если же вы работаете один, то вы вольны поступать как вам удобно и угодно.
Ответ написан
Пригласить эксперта
Ваш ответ на вопрос

Войдите, чтобы написать ответ

Похожие вопросы