Пишут ли в компаниях коммиты в git на русском?

Question

[VladilenOk]

Делаю собственный пет проект, и следственно коммичу фичи на английском языке.

Сам английский хорош на уровне чтения, но вот отвратен на уровне грамматики и построения приложений. Вопрос: принято ли в срезе разработки веб приложений СНГ писать коммиты на русском? Либо все следуют стандартам зарубежных компаний и коммиты только на ломанном английском с гугл переводчиком? Просто условно мне удобнее когда я захожу в репу, вижу родной язык и сразу не гугля незнакомые слова чувствую всю иерархию проекта автора.
Когда же захожу на забургорный репозиторий, даже при знании английского, приходится копать и читать полотно коммента на английском, перед тем как что-то понять.

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

Answer 1

[BorLaze]

ИМХО, в этом случае лучше плохой английский, чем хороший русский.

UPD: вот представь сам - смотришь ты гит соискателя, и там коммент "сдес я делаль пузырек сортировка". Плохо? ну, но фонтан, конечно, но гораздо лучше абсолютно грамотного комментария на монгольском "бзых дащщь бызынг клангмы".

Вот точно так же твоему "потенциальному работодателю" из-за бугра будут смотреться твои комменты на русском :-)

Comments

[CityCat4]

Ну, вообще говоря фраза "здесь я делал сортировку пузырьком" на монгольском будет "энд би бөмбөлөг ангилсан", но само обоснование верное. Не говоря уже о том, что UTF-8 комментарии могут превращаться в черт знает что, например, при выгрузке конфигурации микротика.

[BorLaze]

CityCat4, нет, именно "бзых дащщь бызынг клангмы"

а Ваш гугл-переводчик врет!

:-)))))

[CityCat4]

BorLaze, Обычно в таких случаях спрашивают "Какие Ваши доказательства" :)

[BorLaze]

CityCat4, Обычно в таких случаях отвечают

[CityCat4]

Стебемся? Эт хорошо. Но только в варианте перевода Вы меня не убедили, а посему я считаю, что Вы несете чушь :)

[bezvozni]

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

Answer 2

[Ivan Bogachev]

принято ли в срезе разработки веб приложений СНГ писать коммиты на русском?

У нас как только не пишут. Бывает, что мешают по несколько языков в одном проекте, в том числе и в компаниях, которые себя позиционируют как очень модные. Все зависит от конкретных людей в конкретном месте.

Но чем более подкованные специалисты в команде, тем больше вероятность, что они между собой договорятся все унифицировать и писать коммиты по конкретной схеме (это больше не про язык в вакууме, а про последовательность в проекте, чтобы было проще ориентироваться). Очень вероятно, что при этом выберут английский, т.к. скорее всего "русские" сообщения коммитов будут состоять из:

1. Англицизмов, которые еще и не имеют однозначной транслитерации в кириллицу, что ломает поиск по коммитам.
   
2. Названий классов, файлов, или еще каких-то сущностей из мира кода, которые и так уже переведены и есть в исходниках проекта на английском.
   
3. Набора базовых глаголов, которые ставят в начале предложений, вроде "добавил", "исправил", "удалил".
   

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

Comments

[Сергей Кузнецов]

Лучше использовать неопределённую форму глаголов, по аналогии с англоязычными примерами. Добавить, исправить, удалить…
В сообщениях Git-коммитов предпочтительней повелительное наклонение. Даже стандартные сообщения коммитов слияния начинаются со слова merge (слить), а не merged (слито)

[Ivan Bogachev]

Сергей Кузнецов, Мне кажется это больше вопрос соглашений, тем более, что язык уже другой. Я уже не раз видел холивары на эту тему и пока что в пользу неопределенной формы видел только аргументы вида "мы так делаем, потому что Линус так делает" и "коммит до мержа - не коммит, и сообщение отвечает на вопрос, что он должен сделать", а в пользу прошедшего времени обычно говорят, что "история коммитов выглядит логичнее в прошедшем времени", и что "коммит - это уже результат некой работы, выполненной в прошлом". В целом, если абстрагироваться от бездумного копирования, то и в том, и в другом подходе есть свой смысл. А в русском языке есть еще вариант "добавляет / исправляет / удаляет". Такое сообщение отвечает на вопрос "что делает коммит?". Мне субъективно этот вариант не очень нравится, но когда весь проект такой - то вроде и норм. Я пока еще не слышал историй о том, что кому-то прямо мешала работать форма глаголов в этой ситуации. Главное - не смешивать и быть последовательным.

[Сергей Кузнецов]

Ivan Bogachev, мне как раз режет глаз смешение стилей, когда автоматические сообщения в императиве, а остальные в прошедшем времени. Уж лучше когда единообразно. Так и лаконичней получается и грамотнее. Тем более редко когда коммиты идут сразу в мастер, они почти всегда что-то предлагают изменить, а не констатируют что уже изменено в проекте.

Автоматические сообщения даже локализации не поддаются, и уж тем более невозможно поменять их грамматику. Или есть способ поправить шаблоны?

Answer 3

[Aetae]

Ну, юзается логика. Если проект будет работать только в рамках России без вариантов - и комменты и коммиты - на русском. Иначе - на английском.

Answer 4

[Анатолий Димов]

На Русском коммиты пишут, но я не компания.
А вообще, как принято и почему не удобно вот и вот

Answer 5

[⚡ Kotobotov ⚡]

Работаю в российской компании, очень очень редко видел, чтоб писали на английском описания комитов)
В первую очередь вы эту историю ведете для себя и для своих коллег разработчиков, поэтому лучше исходить из того как вам самим комфортнее работать.
Если команда состоит из русскоязычных, то нет смысла из себя чего-то там выдавливать на английском.
П. С.
есть инструменты которые по определенным стандартам обрабатывают коммиты, они как правило опираются на ключевые слова, например указания типа коммита (fix, feature и тд) эти типы можно расширять разумеется русскими словами, но обычно этим не занимаются, а используют преднастроеные типовые варианты.
Поэтому обычно происходит комбинация и русского и английского, где ключевые слова (например тип комита) на английском, а пояснения и описания на русском.

Answer 6

[Сергей Куплетский]

По опыту работы со старыми репозиториями могу сказать, что главное это чтобы коммиты были понятными, так как сообщения "обновил код" и "update code" одинаково плохие.

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

P. S. На данный момент мы в команде используем соглашение Conventional Commits и в рамках этого перешли на англоязычные коммиты. Мотивация перехода на английский - развитие команды. Предполагаем, что если разработчики привыкнут писать коммиты на английском, то им будет проще в дальнейшем и они повышают этим свою ценность как разработчика (хоть немного).