AZ
Если писать всякую банальщину в доки, которую и так видно по сигнатуре типов, то понятно, что от такой доки мало толку. Но самое интересное начинается когда туда пишутся действительно полезные вещи.
эту ерунду пишут в доке, где типов нет
Size: a a a
2019 December 26
AZ
а еще хуже когда не пишут
AZ
и есть либа, а что с ней делать не знаешь
AZ
в лучшем случае есть аналог с докой и ты просто подключаешь его
AZ
в худшем начинаешь дебажть в рантайме чтобы понять что у объекта есть и что он умеет
KR
ну, ещё сорцы можно раскуривать, что тоже прямо таки не способствует продуктивности при решении задач
NV
ну, ещё сорцы можно раскуривать, что тоже прямо таки не способствует продуктивности при решении задач
На самом деле раскуривать сорцы это чуть ли не самый эффективный способ понять либу
KR
Если внятной доки нет - да.
А⚙
Если математически должно получиться в 2 раза больше
Нет, как раз
c и выходитА⚙
приходи ко мне, можем вместе составить текст 😏
Это что, приглашение на свидание?
NV
Если внятной доки нет - да.
Да и не только, растовскую стд либу я тоже читал, норм заходило
KR
В Rust, мне гораздо менее часто приходится лазать в сорцы либ по сравнению с другими языками как раз таки из-за внятной/удобной доки и привитой культуре её писать.
П@
Это что, приглашение на свидание?
и не только
А⚙
если ты питухонист которые 5к строчек на динамике удерживаешь то тебе раз плюнуть
Очень хорошо смотрится с сообщением выше
А⚙
и не только
Малчий мой
П@
Малчий мой
блять не надо
AZ
В Rust, мне гораздо менее часто приходится лазать в сорцы либ по сравнению с другими языками как раз таки из-за внятной/удобной доки и привитой культуре её писать.
Это хорошо. Смысл в другом.
Если вдруг из раста пропадут все доки, то будет печально, но жить можно будет.
Если из питон/жс экосистемы вдруг пропадут все доки...
Если вдруг из раста пропадут все доки, то будет печально, но жить можно будет.
Если из питон/жс экосистемы вдруг пропадут все доки...
AD
спокуха, это свойская беседа.
KR
Да и не только, растовскую стд либу я тоже читал, норм заходило
Всё зависит от целей. Ничего плохого читания в сорцах для изучения идиоматики или глубокого изучения дизайна/имплементации либы нет. Но для стандартного "баханья задач в прод" постоянно лезть в сорцы запарит и хорошие доки здорово выручают.
KR
Это хорошо. Смысл в другом.
Если вдруг из раста пропадут все доки, то будет печально, но жить можно будет.
Если из питон/жс экосистемы вдруг пропадут все доки...
Если вдруг из раста пропадут все доки, то будет печально, но жить можно будет.
Если из питон/жс экосистемы вдруг пропадут все доки...
Ну, я этот аргумент никак и не парировал. Без типов - плохо, да.