170 похожих чатов

Какой формат докстрингов вы используете? и с какой IDE, текстовым редактором?

12 ответов

46 просмотров

Просто пишу текст

rasput- Автор вопроса
Tishka17
Просто пишу текст

а пробовал что-нибудь другое?

rasput
а пробовал что-нибудь другое?

Я ленивый в плане докстрингов :(

""" Общее описание функции Parameters ----------------------- название параметра(тип данных) - что делает Returns ------------------------- название параметра(тип данных) - что делает """

rasput- Автор вопроса
rasput- Автор вопроса
Vadzim _B
""" Общее описание функции Parameters -----------...

стой, это вообще какая-то примесь гугла и нампая у нампая декларация типов вроде как такая :class:type

rasput
стой, это вообще какая-то примесь гугла и нампая ...

я вообще не знаю про эти нампаи и гуглы, просто у нас с большего принято так писать в компании, да и как по мне, выглядит читабельно, красиво и понятно

Vadzim _B
я вообще не знаю про эти нампаи и гуглы, просто у ...

И какой инструмент понимает это? Ide/генераторы доки?

Tishka17
И какой инструмент понимает это? Ide/генераторы до...

инструмент никакой не понимает, комментарии пишутся для разработчиков, если это какой-нибудь веб-сервер, то отдельно сваггер пишется

а зачем ей понимать?

rasput- Автор вопроса
Vadzim _B
а зачем ей понимать?

для того, чтобы человеку было понятно (она не понимает, а переводит)

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

Обсуждают сегодня

Господа, а что сейчас вообще с рынком труда на делфи происходит? Какова ситуация?
Rꙮman Yankꙮvsky
29
А вообще, что может смущать в самой Julia - бы сказал, что нет единого стандартного подхода по многим моментам, поэтому многое выглядит как "хаки" и произвол. Короче говоря, с...
Viktor G.
2
30500 за редактор? )
Владимир
47
а через ESC-код ?
Alexey Kulakov
29
Чёт не понял, я ж правильной функцией воспользовался чтобы вывести отладочную информацию? но что-то она не ловится
notme
18
У меня есть функция где происходит это: write_bit(buffer, 1); write_bit(buffer, 0); write_bit(buffer, 1); write_bit(buffer, 1); write_bit(buffer, 1); w...
~
14
Добрый день! Скажите пожалуйста, а какие программы вы бы рекомендовали написать для того, чтобы научиться управлять памятью? Можно написать динамический массив, можно связный ...
Филипп
7
Недавно Google Project Zero нашёл багу в SQLite с помощью LLM, о чём достаточно было шумно в определённых интернетах, которые сопровождались рассказами, что скоро всех "ибешни...
Alex Sherbakov
5
Ребят в СИ можно реализовать ООП?
Николай
33
https://github.com/erlang/otp/blob/OTP-27.1/lib/kernel/src/logger_h_common.erl#L174 https://github.com/erlang/otp/blob/OTP-27.1/lib/kernel/src/logger_olp.erl#L76 15 лет назад...
Maksim Lapshin
20
Карта сайта