Git: краткое руководство

В этой небольшой статье будет описан процесс работы с git и GitHub. Описан очень бегло и без большого числа деталей, буду дополнять написанное на основе ваших вопросов.

Начало работы

1. Скачайте и установите git: https://git-scm.com/downloads
2. Перейдите в каталог, где будет лежать папка с проектом.
3. Зажмите Shift и кликните правой кнопкой по пустому месту в проводнике, в меню выберите "Открыть окно shell здесь" или что-то вроде этого. Без зажатого Shift этого пункта в меню не будет.
4. В открывшемся терминале введите команду git clone https://github.com/tossha/urbain.git. В текущем каталоге появится папка urbain с репозиторием, в котором будет вестись вся работа.

Работа над новой фичей

1. Создаете новую ветку - git checkout -b [branch name]
2. Делаете нечто потрясающее, меняя исходный код, добавляя новые файлы и т.п..
3. Добавляете все изменения в новый комит: git add .
4. Комитите изменения: git commit -a
5. Указываете осмысленное сообщение.
6. Обновляете локальный репозиторий - это важно, чтобы ваши изменения кода не конфликтовали с изменениями кода ваших коллег: a. git fetch b. git rebase origin/master
7. Исправляете все возникшие конфликты, если необходимо.
8. Когда все готово вам нужно загрузить ваши изменения на гитхаб: git push -u origin [branch name]
9. Заходите на гитхаб: https://github.com/tossha/urbain
10. Нажимаете Compare & Pull Request напротив вашего нового бранча.
11. Готово! Ждете комментариев от меня, либо Антона.
12. Получив комментарии вам необходимо их поправить.
13. Правите комментарии локально и комитите их в существующий бранч, можно даже в существующий коммит: git commit -a --amend
14. git push -u origin authors -f для того, чтобы загрузить новую версию на github, флажок -f обязателен!
15. Получаете новую порцию комментариев, либо если все хорошо я, либо Антон, складываем ваши изменения в master ветку и вы можете начинать работать над следующим патчем с начала этой инструкции.

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