Должна быть документация для разработчиков. Комментики - ну такое. Там много не напишешь, имхо

Документацией(не из инетика), кстати, я проникся лет восемь назад. Увольнялся тимлид - и он два последних месяца корпел над доками. В итоге получился 200 страничный мануал вообще по всему, что было сделано, как работает, по всем методам и классам.

Должна быть документация для разработчиков. Комментики - ну такое. Там много не напишешь, имхо

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

комментарии нужны, но по делу

плохой комментарий хуже отсутствия его

комментарии нужны, но по делу

можно пример комментов по делу?) Не то что не верю, просто в голову не приходит что-то

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

Было бы так всё просто - доки не были бы нужны. Исходник открыл - и усё понятно. Но нет. Не понятно

Было бы так всё просто - доки не были бы нужны. Исходник открыл - и усё понятно. Но нет. Не понятно

это разные уровни. В доках пишут, как кодом пользоваться, как его расширять и тд. Никто не объясняет по шагам функции в документации.

А комментарии пишут, чтобы как раз объяснить принцип работы кода.

можно пример комментов по делу?) Не то что не верю, просто в голову не приходит что-то

по делу - например описание для чего делается какое-то вычисление. Или описание откуда взята константа

комментарии нужны чтобы объяснить, зачем делается то или иное неочевидное действие

особенно если это нельзя объяснить никак иначе

реальный пример у меня на работе ecc = ecc >> 22 | ecc < 2;

MAX_PACKET_SIZE = 256 # мы должны гарантировать что наши сишные друзья смогут прочитать пакет за раз

и комментарий "поправляем layout"

мне пришлось пойти к железячникам, найти в доке на контроллер оперативки табличку, как считается ecc, сопоставить с докой на линуксовый подсчет ecc, найти отличие

почему-то не запускается фласк, пробовал env переменную выставить

и после этого накатать коммент на 10 строчек, чтобы объяснить, зачем вот так два бита перекидываются. И коммит. Коммит коммент строк на 40, с полным объяснением

команду хоть покажи

команду хоть покажи

flask db upgrade, самая верхняя строка

и после этого накатать коммент на 10 строчек, чтобы объяснить, зачем вот так два бита перекидываются. И коммит. Коммит коммент строк на 40, с полным объяснением

жостко, я бы ссылку на доку просто приложил

там одной доки недостаточно, надо курить две разные доки, чтобы найти между алгоритмами расхождение

у тебя есть и папка app и файл app.py

плюс терминология разная

у тебя есть и папка app и файл app.py

да, это меня и удивляет

да, это меня и удивляет

Ну так что он по твоему импортирует?

Я вот не знаю

в смысле в одной доке одна терминология, в другой другая. И надо было отдельно думать, как выстроить соответствие между ними. Оказалось - передвинуть два бита из конца в начало.

Короче, лучше оставь что-то одно

там одной доки недостаточно, надо курить две разные доки, чтобы найти между алгоритмами расхождение

Смержи их))

Короче, лучше оставь что-то одно

ай, это была одна из попыток без app.py результат тот же самый

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

а переменная с приложением в пакете есть?

окружение то же самое

а переменная с приложением в пакете есть?

FLASK APP?

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

да не

в пакете app как называется?

А без смены языка нельзя?

я еще nuitka когда-то компилировал

что за пздц ...

что???? методы на русском?

Лечиться пора

Ух ебаа

выколите мне глаза

У англичан не припекает с методов на английском а у этих припекает. Странные пздц

жестко

Технически это можно в питоне. А в остальном - это конечно для мазахистов, которые любят переключаться туда-сюда с разных языков, смотреть как красиво меняется индикатор языка.

что???? методы на русском?

питон поддерживает юникод, что такого? Там где уместно, методы могут быть на чем угодно

нигде не уместно

питон поддерживает юникод, что такого? Там где уместно, методы могут быть на чем угодно

Есть же общепринятая стандартизация языка. Зачем русские методы и атрибуты мешать с английским синтаксисом?

Это похоже на "садистов", которые создают вот такие локализованные домены: www.я-крутой.рф

У англичан не припекает с методов на английском а у этих припекает. Странные пздц

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

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

При чем тут мир вообще?

А как же 1с

А как же 1с

А как же кумир

Или php

А как же brainfuck

При чем тут мир вообще?

При том

Идите на 1С тогда со своей кириллицей

А как же 1с

В 1С наверное можно писать весь код ни разу не переключившись на английскую раскладку. Иначе бы их давно все говном закидали.

При том

Так себе аргумент.

Вот там как раз так принято

Вот попробуйте спарсить xml c тегами на кирилице там у объектов методы на русском

А тут будет смешение раскладок

Будете туда сюда переключать

А тут будет смешение раскладок

Неудобно это второй вопрос. И я с этим соглашусь

В 1С наверное можно писать весь код ни разу не переключившись на английскую раскладку. Иначе бы их давно все говном закидали.

Там для точек с запятой нада переключаться

Там для точек с запятой нада переключаться

Не надо)

Там для точек с запятой нада переключаться

зачем? Шифт-4 же

Там для точек с запятой нада переключаться

Shift + 4

Неудобно это второй вопрос. И я с этим соглашусь

И не принято

а еще можно временный переключател ьсделать

хз у меня английская раскладка, там такого нет

И не принято

И ты тут такой ссылку на пеп

Вот попробуйте спарсить xml c тегами на кирилице там у объектов методы на русском

Изи, тыщу раз так делал

Должна быть документация для разработчиков. Комментики - ну такое. Там много не напишешь, имхо

Те, кто пишут комментарии, мыслят догмами)))

И ты тут такой ссылку на пеп

Это неформальное соглашение

Это неформальное соглашение

лол

У англичан не припекает с методов на английском а у этих припекает. Странные пздц

Представляю если бы арабы, китайцы, японцы писали бы методы на своих иероглифах, нихераж нипанятна?

Я не про то что это сложно, я про то что там тоже приходится писать object.товар.название

лол

Что лол то? Большинство кода на английском

Представляю если бы арабы, китайцы, японцы писали бы методы на своих иероглифах, нихераж нипанятна?

Они итак это делают в общем то

Что лол то? Большинство кода на английском

Да и что?

Они итак это делают в общем то

не встречал чот, видел ток камменты в коде, но код пишут на инглише?

Да и что?

И то, если будешь на русском писать, то тебя закономерно пошлют в 1с в питон чатике

не встречал чот, видел ток камменты в коде, но код пишут на инглише?

Не встречал > не существует. Понятно.

И то, если будешь на русском писать, то тебя закономерно пошлют в 1с в питон чатике

Ну в ответ тебя пошлют туда же

Ну в ответ тебя пошлют туда же

Неа

Народ, а кто-то знает. Вот у меня два монитора и KDE. Я могу на них независимо как-то переключать рабочие столы?

Неа

Да пошёл ты в чатик 1С

Да пошёл ты в чатик 1С

Дв ты просто сам одинэсник и любитель кириллицы

Так что не считается

Народ, а кто-то знает. Вот у меня два монитора и KDE. Я могу на них независимо как-то переключать рабочие столы?

Мне кажется, нет