Портфолио на GitHub: рекрутеру нужны 3–5 проектов, а не зелёный график

GitHub в руководстве для соискателей советует закрепить 3–5 проектов, относящихся к желаемой роли. Выберите работы, по которым можно понять задачу, ваш вклад и результат, затем приведите в порядок их описания и инструкции по запуску. Так рекрутеру будет проще перейти от страницы профиля к конкретной работе.

Начните с отбора репозиториев, затем оформите каждый как проверяемый проект: объясните, что он делает, где посмотреть результат и как запустить код. Профиль дополните кратким описанием специализации и закрепите выбранные работы. Цветные ячейки календаря активности показывают вклад на платформе, но сами по себе не объясняют назначение проекта или вашу роль в его создании.

Выберите работы под конкретную роль

Просмотрите свои репозитории с точки зрения вакансии, на которую собираетесь откликнуться. Для разработчика интерфейсов законченный интерфейс с доступной демонстрацией может быть убедительнее сложной работы из другой области. Если ищете работу в разных направлениях, показывайте прежде всего проекты, относящиеся к текущему отклику: состав и порядок закреплённых репозиториев можно менять.

У каждого кандидата проверьте три свойства: понятен ли результат, видны ли ваши технические решения и сможет ли посторонний человек запустить проект по инструкции. Похожие учебные задания редко добавляют друг другу ценности; работы с разными задачами лучше раскрывают диапазон навыков. Совместный проект тоже подходит, если можно показать именно вашу часть работы.

Отсутствие заказчика не делает учебный проект бесполезным. Обозначьте его происхождение, исходную задачу и принятое решение; такой подход помогает представить учебную работу как кейс. Незавершённый проект выбирайте только тогда, когда в нём уже есть результат для осмотра, а границы готовой работы указаны честно.

Сделайте описание репозитория маршрутом к результату

Справка GitHub о README относит к его основным задачам объяснение назначения и пользы проекта, а также способа начать работу с ним. В портфолио файл должен провести посетителя дальше: от поставленной задачи к запуску, демонстрации и проверке результата. Пишите для человека, который впервые открыл репозиторий и ничего не знает о ваших прежних настройках.

1. Сначала назовите задачу, предполагаемого пользователя и доступный результат. Фраза «приложение на React» сообщает о технологии, но не объясняет, что делает приложение.
2. Опишите основные возможности и существенные технические решения. Укажите ограничения, которые повлияли на выбор инструментов или устройство проекта.
3. Перечислите необходимые инструменты, зависимости и команды установки и запуска в рабочем порядке. Если нужны переменные окружения, назовите их без публикации секретных значений.
4. Добавьте ссылку на работающую демонстрацию, если она есть. В противном случае опишите воспроизводимый сценарий и ожидаемый результат.
5. Укажите команду запуска тестов и то, что они проверяют. Если тестов нет, не создавайте впечатление, что они предусмотрены.

Короткое описание рядом с названием репозитория должно сразу называть его назначение. Если доступна демонстрация, добавьте её адрес и в сведения о репозитории: так результат можно найти до чтения кода. Проверьте, что ссылка открывает именно описанную версию, а инструкция по запуску не зависит от файлов и настроек, оставшихся только на вашем компьютере.

Покажите личный вклад в совместный проект

В командной работе общий результат не объясняет, за что отвечали вы. Назовите свою часть — например, обработку запросов, отдельный пользовательский сценарий или настройку тестов — и укажите, где её можно увидеть: в модуле, запросе на включение изменений либо обсуждении решения. Не приписывайте себе весь проект, если выполняли ограниченную задачу.

Для собственной работы тоже полезно раскрыть ход решения. Кратко опишите ограничение, выбранный подход и его последствия. Условный пример: если учебное приложение сохраняет данные только в браузере, прямо укажите это и поясните, почему в этой версии не понадобился сервер. Такое объяснение даёт собеседнику предмет для технического разговора и помогает оценить проект в его действительных границах.

Перед закреплением просмотрите выбранные репозитории глазами нового участника: понятны ли названия файлов, актуальны ли команды, не ведут ли ссылки на удалённые страницы. Необязательно за вечер исправлять весь архив. В первую очередь приведите в порядок работы, к которым сами направляете внимание посетителя профиля.

Оформите профиль как точку входа

В кратком описании профиля назовите специализацию и работу, которую ищете. Добавьте действующую ссылку на резюме или сайт, если они помогают оценить опыт. Длинный перечень знакомых инструментов здесь менее полезен, чем ясное указание роли: навыки посетитель сможет проверить в закреплённых проектах.

Если места в кратком описании недостаточно, создайте профильный README. Для нового профиля он появится при выполнении условий GitHub для профильного README: публичный репозиторий должен называться точно как имя пользователя, а в его корне должен лежать непустой файл README.md. В нём можно кратко описать специализацию, опыт и причины выбора представленных работ.

Профильный README служит навигацией, а описание отдельного проекта — инструкцией для его изучения. Из профиля ведите читателя к нужным репозиториям; команды установки, тесты и ограничения оставляйте рядом с кодом. Так при смене состава закреплённых работ не придётся поддерживать несколько копий одной инструкции.

Закрепите работы и пройдите путь посетителя

Когда описания готовы, закрепите выбранные репозитории в профиле. Первым поставьте проект, наиболее близкий к нужной вакансии; следом — работы, которые показывают другие навыки или участие в команде. Порядок помогает посетителю быстро найти релевантный пример, даже если он не откроет весь список.

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

Читайте также:

• Портфолио без клиентов: учебный проект станет кейсом, если показать решение
• Почасовая или фиксированная оплата: что выбрать фрилансеру для разных проектов
• Интернет-проект с нуля: сначала проверка спроса, потом большой бюджет