Это код из движка quake

Это быстрый обратный корень

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

Ну это да, но такое не часто нужно

Я это как давольно жуткий пример привел)

Код то работает, даже очень хорошо

Но без объяснения хер поймешь

Когда команда коллег более-менее статична из года в год, но, увы и ах, реалии совсем другие для большинства участников ит-рынка

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

Вот это всё мне показалось мне довольно магическим, и я написал комментарий.

Ну ещё у меня есть парочка TODO'шек.

Вот TODO это очень хорошо

IDE сразу подсвечивает, и можно сразу продолжить

А не сидеть и думать, что я блять хотел сделать

Пушо у меня часто было, что придумывал что то, оставлял на потом

И забывал

А если Вам поступит предложение более выгодное от другого ЮЛ, то что станет с Вашим текущим проектом?

Ничто, потому что я для себя делаю

По твоему, если я не буду подписывать мост как // это мост, или get_account_by_username_begin как // gets account by username begin или select(Account).where(Account.registration_datetime > required_datetime) как // selects accounts where registration datetime is later than required datetime проект перестанет не будет понятным?

Я, например, обычно описываю не только саму функцию, но и то, где она используется. Все зависит от сложности приложения