Зачем это новичку
Участие в открытом проекте даёт то, чего не даёт ни один учебный: настоящий код, написанный не для обучения, чужие правила и публичное обсуждение ваших изменений.
И это видно всем. Ваши правки открыты, историю можно посмотреть, обсуждение — прочитать. Проверять на слово ничего не надо.
Как выбрать проект
Главная ошибка новичка — идти в самый известный проект. Там очередь из желающих, строгие требования и месяцы ожидания ответа.
Ищите другое:
- Небольшой проект, где поддерживающий отвечает за день-два. Посмотрите даты последних ответов — это видно сразу.
- Живой. Изменения за последний месяц, а не за позапрошлый год.
- Знакомый вам. Инструмент, которым вы пользуетесь, понять намного проще.
- С пометками для новичков. Многие проекты помечают задачи как подходящие для первого раза.
С чего начать
С малого. Нормальные первые шаги:
- Опечатка или неточность в документации. Это не стыдно — наоборот, поддерживающие такое любят.
- Пример, которого не хватает. Разобрались сами через боль — опишите.
- Небольшая ошибка из тех, что помечены как простые.
Задача первой правки — не впечатлить, а пройти путь целиком: сделать ответвление, внести изменение, оформить запрос, ответить на замечания. Дальше страшно уже не будет.
Как оформить изменение
- Прочитайте правила участия. Почти в каждом проекте есть файл с ними, и половина отказов — потому что его не открыли.
- Одна правка — одна задача. Не смешивайте исправление ошибки с переименованием переменных.
- Опишите, что и зачем. Коротко, но по делу.
- Проверьте, что тесты проходят.
Что делать с замечаниями
Их будет много, и это нормально. Разбор кода в открытых проектах бывает резким, но почти всегда по делу.
Правило простое: не спорьте с первой реакции. Прочитайте, попробуйте понять, задайте вопрос, если не поняли. Если не согласны — объясните почему, спокойно и по существу.
Умение принимать замечания — отдельный навык, за который на работе ценят отдельно.
Если ответа нет
Бывает: поддерживающий пропал или проект заброшен. Не считайте это провалом — просто выберите другой.
И помните, что открытые проекты не единственный способ поработать с чужим кодом. В командном проекте вы получите то же самое, только с людьми, с которыми можно договориться напрямую.
Хватит читать — пора делать
На CohortX можно найти команду под пет-проект и получить тот самый опыт, о котором спрашивают на собеседовании.
Похожие статьи
- Your first pull request: step by stepThe whole path from picking an issue to a merged change: the commands, the write-up, and what to do with review comments.
- Первая правка в чужой проект: пошаговоПолный путь от выбора задачи до принятого изменения: команды, оформление и что делать с замечаниями.
- Open source for beginners: how to start contributingHow to pick a project you can handle, what to do first, and why fixing a typo in the docs is a perfectly good start.