Практика по пулл реквестам
TL;DR: В GitByBit теперь можно потренироваться создавать пулл реквесты!
Бывало такое: находишь ошибку в чужом коде и думаешь: «Почему они это до сих пор не исправили?». Заводишь тикет, ждёшь... и ничего не происходит.
Но суть в том, что больше не нужно ждать.
Можно просто засучить рукава и исправить всё самостоятельно. Создай пулл реквест, дождись слияния — и внезапно все, кто пользуется этой библиотекой, скажут тебе спасибо.
Никогда не знаешь, что вытянешь из пулл реквеста.
Настоящая ошибка, настоящее исправление
Практика начинается со знакомой ситуации: приложение-трекер для фитнеса падает, если кто-то пытается записать активность на поле для гольфа в ярдах. Приложение не умеет конвертировать ярды в метры и вылетает. Исправление банальное — добавить недостающую конвертацию (1 ярд = 0,9144 метра). Патчишь библиотеку и идёшь дальше по своим делам.
Но через какое-то время выходит обновление, которое ломает твоё исправление. Приходится накатывать патч заново. Потом снова. И снова. В какой-то момент понимаешь, что тратишь время на бессмысленное повторение патча, тогда как исправление должно быть в самой библиотеке. Но как его туда закинуть?
Великий и ужасный пулл реквест
Большинство проектов с открытым кодом живут на GitHub или похожих платформах, и все они поддерживают пулл реквесты. Пулл реквест — это способ предложить изменения в проект. Делаешь форк репозитория, вносишь правки, а затем отправляешь пулл реквест в оригинальный репозиторий, предлагая влить твои изменения в основную кодовую базу.
Помимо технических моментов вроде форков, веток и слияний, пулл реквест — это ещё и общение. Нужно объяснить, что именно было сделано, зачем это нужно и как это улучшит проект. Здесь можно показать, насколько хорошо ты понимаешь кодовую базу и можешь реально помочь проекту. И будет очень обидно запороть пулл реквест дурацкими сообщениями коммитов, кучей не связанных между собой правок или несоблюдением правил контрибьютинга.
С таким подходом в комментариях к пулл реквесту далеко не уедешь.
К тому же обсуждение пулл реквеста может заставить обновить форк, сделать ребейз и разрулить конфликты. В этом процессе задействован целый арсенал навыков работы с Git, и теперь их все можно отработать в GitByBit на реалистичном сценарии с настоящими GitHub-репозиториями.
Чтобы успешно провести пулл реквест, потребуется много терпения и внимания к деталям.
Помимо практики по пулл реквестам, я добавил несколько новых статей в Gitопедию: и . А ещё в разделе лучших практик появились два новых материала: и .
