Торвальдс объявил войну страдательному залогу в коммитах
Линусу Торвальдсу не нравится, когда разработчики используют страдательный залог в своих сообщениях. Вместо этого он призвал применять только действительный залог, потому что считает эту глагольную категорию более благозвучной.
Торвальдс пожаловался, что некоторые мейнтейнеры используют пассивный залог и этим создают для него лишнюю работу. Ему приходится переписывать сообщения вручную, чтобы сделать их более связными.
Для примера он привёл фразу: «…обработка ошибок драйвера … была исправлена, чтобы избежать разыменования указателя NULL». Торвальдс предложил изменить её на: «Это исправляет нулевой указатель…».
Но ещё лучше, по мнению знаменитого программиста, строить предложения с повелительным наклонением вроде: «Исправь …». Такие формулировки он считает максимально простыми и понятными.
8 актуальных и интересных курсов по Rust (июнь 2023) + бонус от GitHub
Рассмотрели преимущества и особенности языка Rust, а также сделали подборку курсов по нему, которые будут интересны как новичкам, так и опытным программистам.
Для примера он привёл фразу: «…обработка ошибок драйвера … была исправлена, чтобы избежать разыменования указателя NULL». Торвальдс предложил изменить её на: «Это исправляет нулевой указатель…».
Я думаю читатели ещё не слишком отупели и такие цитаты можно не переводить
Это потому что в культуре США вместо конкретно фразы исправь этот код принять 100500 раз извиниться, сообщить как мне жаль и в конце попросить ласково поправить маленькие ремарочки.
->Лучше четко сказать исправить и указать код.
Релоцировались? Теперь вы можете комментировать без верификации аккаунта.
Ну правильно. А то как настрочат простыней.
Как, например, ты
причем тут простыни? почитай про "залоги" и мб поймешь о чем вопрошает Линус
Я думаю читатели ещё не слишком отупели и такие цитаты можно не переводить
Делом бы лучше занялся
Это потому что в культуре США вместо конкретно фразы исправь этот код принять 100500 раз извиниться, сообщить как мне жаль и в конце попросить ласково поправить маленькие ремарочки.
->Лучше четко сказать исправить и указать код.
Эту его простыню можно заменить простым: "пишите кратко и строго по существу"
причем тут краткость вообще? Он говорит что надо описывать что комит делает(исправляет НПЕ), а не его влияние(ошибка была исправлена).
https://www.conventionalcommits.org/en/v1.0.0/
мне наоборот больше пассивный залог нравится, это звучит более как история