How we work with PRs

[rizomaa]

Пачалі дыскусію тут #249

Галоўная задача:

Сварыць гайд па працы з gitflow

1. просты
2. і зразумелы для пачынаючых распрацоўшчыкаў

[Anthony-Hoopkins]

I. В самом начале работы необходимо сделать форк «Main» репозитория (см. gitbook или др.), что создаст отдельный удалённый github-репозиторий у вас в github-аккаунте.

II. Перад пачаткам працы забраць змены на апстрыме («Main» репозитории).
Cделать git pull develop ветки с «Main» репозитория в свою локальную develop ветку (см. gitbook или др.).

III. Кожная ішу (задача/таск) - гэта асобная галіна гіта.

Каждое новое задание ишу (задачу/таск) делать в новой ветке:

1. От ветки develop создать отдельную ветку у себя в локальном репозитории (см. gitbook или др.). Использовать префиксы вида: «feature/», «bugfix/», «hotfix/» (пример: «feature/EXP-14_registration-request»)

2. Название ветки должно содержать префикс и идентификатор задачи + 2-3 слова из названия задачи (для более простой идентефикации не только по номеру). Пример: «feature/#17_add-new-feature»

3. Сообщение коммита: пример: «feature([GDB4] Push/Pull data from initiatives / events between Mapa and GoodDB. #17): add new feature in mapa project». (по номеру гитхаб перелинкует задачу с коммитом)

4. Все изменения/правки/фиксы которые касаются данной задачи делать в этой ветке.

5. Отправлять в одном «Pull request» только один коммит (1 Pull request = 1 Commit)

доп.1) В случае дополнительных коммитов слить коммиты в один при помощи « –rebase»
Для того, чтобы объединить несколько коммитов в один, использовать конструкцию: «git rebase -i » (более подробная инструкция) http://gitready.com/advanced/2009/02/10/squashing-commits-with-rebase.html или (см. gitbook или др.)

доп.2) Для обновления своей ветки и подтягивания новых изменений из develop так же используйте « –rebase» своих комитов.

IV. Вырашаная ішус пулрэквэсціцца на dev галіну апстрыма.

После того, как разработчик выполнит «задачу», он должен:

1. Отправить «push» своей локальной ветки под названием например «feature/#17_add-new-feature» в свой удалённый github-репозиторий (который до этого форкали с «Main» репозитория см. п. I) - в вашем репозитории появится новая ветка с названием «feature/#17_add-new-feature»

2. Создать «Pull request» своей ветки из удаленного репозитория «feature/#17_add-new-feature» в ветку «develop» «Main» репозитория (при помощи github).

доп.1) В случае конфликтов, разрешить их при помощи того же« –rebase»;

доп.2) Отправлять код в ветку «master» разрешено только со статусом «hotfix»

[rizomaa]

@Anthony-Hoopkins мне усё крута зразумела і я падтрымліваю. Магчыма напісаць на бел або англійскай мове.

Адзінае у мяне пакуль белая пляма з rebase. Я пачащ чытаць артыкулы, але кали ты маеш практыку цикава будзе паглядзець як ты фіксіш канфлікты, або склейваеш камміты.

Наогул чаму лічыш. што у ПР павінен быць толькі адзін камміт?

"Отправлять в одном «Pull request» только один коммит (1 Pull request = 1 Commit)"

Я нагул таксама за прыгажосць у гэтым плане, але калі навічок працуе з ішус, чым больш звязных каммітаў робіць. тым больш бачны яго развяжанні і паслядоўнасць... ну карацей я гатовы да рэбэйза, толькі зрабіц нейкі інтра на практычных прыкладах, каб калі, што я пасля мог тлумачыць прыбыўшым як гэта разруліваць на практыцы =)

[Anthony-Hoopkins]

@rizomaa

"Отправлять в одном «Pull request» только один коммит (1 Pull request = 1 Commit)"

• это тоже можно сделать как доп. (для продвинутых разработчиков) - а на начальном этапе можно и с парой коммитов.

• По ребейсу можно на каком-то примере записать видос.

• По поводу перевода - могу на английский, но не уверен что в ближайшее время.

[rizomaa]

@Anthony-Hoopkins ок. з усім згодзен=))) занось усё ў вікі.
наконт відоса, як будзеш гатовы можам зладзіць сустрэчу на базе і запісаць.

[rizomaa]

Магчыма узяць гэты варынт, ён перавараны з камандай Doika...
https://github.com/diglabby/doika/wiki/Распрацоўшчыку.-Git.-Праца-з-рэпазіторыем