Работа с git

[temikfart]

Утвержденные правила появятся в категории Announcements.

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

Предлагаю следующие вещи:

Commit'ы

<Краткое описание (не более 50 символов)>
<Пустая строка>
<Подробное описание (не более 72 символов в ширину)>

Краткое описание будет иметь вид: [#123] Add unit tests. То есть:

• сначала в квадратных скобках пишется номер issue, к которому относятся изменения;
• затем, с большой буквы следует краткое описание коммита;
• описание коммита обычно начинается с глагола в инфинитиве (комит описывает "какие изменения он делает", а не "что было сделано").

Остальное:

• Пустая строка отделяет длинное описание коммита от короткого;
• Длинное описание опционально, если в коротком описании непонятно, что было сделано;
• Длина в 50 символов общепризнана.

Branch'и

feature/123-test-io-module
Здесь:

• сначала пишется токен token/, который группирует ветки. Это могут быть:
  • feature
  • fix
  • и др. (нужно дополнить)
• далее пишется номер issue;
• аналогично короткому описанию коммита, пишется краткое описание того, что добавляет эта ветка, в примере написано test-io-module, т.е. добавится тестирование input/output модуля.

merge vs. rebase

Я думаю, что лучше всего использовать git rebase. Никаких merge и squash'ей!.