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

просто так и вникать не надо.

А, да. Особенно для блоков с математикой, в которой магические константы есть

На самом деле, если константы упихнуть в структуру, дать нормальные имена, то все неплохо читается и без комментирования строки. Обычно достаточно дать комментарий на какие особенности метода

Я как-то пилил стабилизацию освещенности для домашнего "рабочего" стола. Ничего сверхитрого: фотодиоды, логарифмические усилители, микроконтроллер, ШИМ и светодиодные модули наверху.
В коде были магические подобранные методом тыка константы для компенсации логарифмического восприятия глазами уровня освещённости. Я хз как такое можно назвать понятным именем и хз как вспомнить через некоторое время что это за цифры и откуда.
Так шта и такое не всегда реально и не всегда всю глубину значений может отразить.

Тут конечно по возможности уже нормальный нейминг и коммент в описании метода. Понятно, что единой таблетки на все случаи нет. Просто мне пригорает, когда те же коэффициенты ПИД регуляторов подобрали или смоделили, в код занесли тупо цифрами и все, пиздец)) Хорошо, если еще дали норм имя методу и понятно что происходит

Я то думал, что именно нормал мод индуктивность может образовывать контур, который звенит. А микросекунды между шин или относительно корпуса фигачишь?

кто знает где можно найти даташит на этот "прекрасный" АЦП?
К512ПВ1

Имхо обилие нормальных комментариев никогда и никому не помешает. Если ты такой Есус, то просто не смотри в них, смотри код, благо ide современные позволяют "погасить" комменты, например, задав им бледно серый цвет в цветовой схеме.

Без комментариев даже в своих проектах, которым 3-4 года разобраться сложно. В последние года 1,5 перешел на связку "комменты+микро коммиты+подробная структурная схема графическая" и это позволило не только самому сильно проще дорабатывать код и еще другие люди без проблем могут разобраться что в нем происходит.

P.S. не синьор и даже не помидор и проекты не сильно большие

Уже  только одно "шедулер на спутник на питоне"питоне" заставляет задуматься.
Если этот код будет ковырять только он, ну, максимум, кто-то, кому дадут много времени чтобы разобраться в коде - допустимо. Но в общем и целом когда я пишу код вообще без комментов не для себя лично, я знаю что поступаю как, простите, мудак. И не втираю про бест пруктисес.

Есть несколько простых правил
именуете функции по смыслу
переменные - тоже самое
уже половина кода понятна будет

Для флайбека в принципе норм. Какая индуктивность первички расчетная?

это, кстати, действительно так? я про код.
встречал полярные мнения, интересно послушать чат

Действительно да. Если это не код библиотеки и публичная его часть. Документация устаревать может быстрее, чем код. Актуально и удобно поддерживать рисунки по архитектуре, модулям

Ребят, помогайте. Не могу в родной jlink flasher найти проц efm8. на оф страничке пишут что он поддерживается. Также видится через консоль, а вот в списке основной проги его нет. в чем дело может быть? Кто сталкивался?