Просто пишу текст
а пробовал что-нибудь другое?
Я ленивый в плане докстрингов :(
""" Общее описание функции Parameters ----------------------- название параметра(тип данных) - что делает Returns ------------------------- название параметра(тип данных) - что делает """
да, это называется numpy
Первый раз такое вижу
стой, это вообще какая-то примесь гугла и нампая у нампая декларация типов вроде как такая :class:type
я вообще не знаю про эти нампаи и гуглы, просто у нас с большего принято так писать в компании, да и как по мне, выглядит читабельно, красиво и понятно
И какой инструмент понимает это? Ide/генераторы доки?
инструмент никакой не понимает, комментарии пишутся для разработчиков, если это какой-нибудь веб-сервер, то отдельно сваггер пишется
а зачем ей понимать?
для того, чтобы человеку было понятно (она не понимает, а переводит)
Обсуждают сегодня