True story)⁠⁠

Все правильно. У меня есть папочка, где лежат скрипты, которые я сам писал, но в сути работы которых до сих пор разобраться не могу. Потому что прошло несколько лет и я просто все забыл.
А были бы комментарии..

Вот это очень хороший вопрос об очевидности и что кажется очевидным тебе самому в данный момент. Есть такой инструмент - code review, одной из плюшек которого и является проверка этой самой очевидности. Если мне на ревью задают вопросы "почему?", а уж тем более "как?" или "зачем?", то это тревожный звоночек и этот кусок кода нужно рефакторить.

Так же, хочу убедится, что меня поняли правильно. Я не сказал, что комментариев в коде не может быть абсолютно. Но их наличие является предупреждением, что что-то начало идти не так. За исключением реализации сложных математических алгоритмов, там без комментариев и описания действительно все тухло. Ну, или при работе со сторонними библиотеками, которые могут вести себя весьма "загадочно" и нет варианта от них отказаться.

И если так посмотреть, то выше перечисленные случаи, а так же не перечисленные, при которых код требует комментария - являются вынужденными исключениями (ставят разработчика в затруднительную ситуацию). Во всех остальных случаях, если тебе требуется прокомментировать сам код, то это: 1. неадекватные названия переменных, 2. недостаточный рефакторинг (это как сложность алгоритма работы так и его обширность), 3. недостаточные знания проекта и платформы, 4. ошибки на на уровне архитектуры.

Если с тремя первыми ты в состоянии справиться сам (поменять имена, упростить алгоритм или разбить слишком большой метод на несколько приватных), то с третьим вариантом действительно проблема. Тут все зависит от того, на сколько глубоко лежит эта ошибка, сколько есть времени и т.п. Четвертый пункт, опять же является исключительной ситуацией и при хорошо поставленной работе компании возникает крайне редко.

При старте компании, начальник отдела разработки по каким-то причинам был категорически против сторонних библиотек. Так что даже для получения rtsp потока написан свой плагин, а не заиспользован live555. То же самое касается всего остального, вплоть до алгоритмов распознавания. Готовые решения может и есть, но у нас свои. Так же, эти два проекта не являются единственными, есть несколько клиентов этого самого сервера на wpf. И они не являются маленькими. Посему, у нас все свое и рукописное.