GitHub-профиль разработчика: портфолио, которое помогает найти работу
Смотрят ли GitHub на собеседовании, как оформить profile README и закреплённые репозитории, какие пет-проекты показывать и что лучше спрятать: ключи, учебный мусор, чужой код.
Коротко
| Вопрос | Ответ |
|---|---|
| Смотрят ли GitHub | чаще всего бегло: 1–3 минуты, и в основном у джунов и при смене стека |
| Что видят первым | profile README, закреплённые репозитории, README открытого проекта |
| Сколько проектов нужно | 2–3 доведённых до конца лучше двадцати заброшенных |
| Что важнее всего в проекте | README с описанием, запуском и скриншотом, тесты, внятная история коммитов |
| Что спрятать | секреты в истории, копии туториалов, решения тестовых заданий, код работодателя |
| Зелёные квадратики | почти никого не впечатляют; их отсутствие у мидла с NDA-работой — норма |
GitHub не заменяет резюме и не решает исход собеседования. Его задача скромнее: подтвердить то, что написано в резюме, и не дать повода усомниться. Хороший профиль — это пять минут работы рекрутера и тимлида, после которых у них меньше вопросов, а не больше.
Смотрят ли GitHub на самом деле
Честный ответ: смотрят не все и не всегда, а когда смотрят — недолго.
Рекрутер обычно не читает код. Он открывает ссылку, чтобы убедиться, что профиль живой: есть проекты по заявленному стеку, есть описания, нет пустоты. Решение «звать или нет» он принимает по резюме, а GitHub лишь добавляет или снимает очки.
Технический интервьюер или тимлид может открыть один-два репозитория перед созвоном, чтобы задать вопросы по коду. «Почему здесь синхронные запросы к базе?», «Как бы ты это масштабировал?» — такие вопросы по вашему же проекту встречаются на техническом скрининге и в разговорах с тимлидом. Это хороший сценарий: обсуждать свой код проще, чем абстрактные задачи.
Где GitHub весит больше всего:
- Джуны и стажёры. Опыта работы нет, и проекты — единственное доказательство, что вы умеете довести код до работающего состояния.
- Смена стека или профессии. Три года на Java и вакансия на Go: репозиторий с сервисом на Go снимает вопрос лучше любого сопроводительного письма.
- Опенсорс-ориентированные компании и вакансии, где прямо просят ссылку на код.
- Удалённый найм в зарубежные компании, где кандидата хочется проверить до затратного цикла собеседований.
Где почти не весит: мидлы и сеньоры с подтверждаемым опытом. Их код живёт в закрытых репозиториях работодателя, и это все понимают. Пустой публичный GitHub у человека с пятью годами коммерческой разработки — не красный флаг. А вот ссылка на пустой профиль в резюме — уже небрежность: если показывать нечего, ссылку лучше не ставить.
Профиль не обязан быть идеальным. Он обязан не противоречить резюме. «Senior Python Developer» в резюме и три форка учебных курсов по JavaScript в профиле — вопрос, который вам зададут.
Как профиль выглядит со стороны
Откройте свой профиль в режиме инкогнито — так его видит посторонний человек. Сверху вниз:
- Аватар, имя, короткое био, город, ссылки. Фото или нейтральная картинка, настоящее имя или узнаваемый ник, одна строка о себе: «Backend на Python и Go, интересуюсь распределёнными системами». Контакты — почта или Telegram.
- Profile README — блок Markdown прямо на странице профиля.
- Закреплённые репозитории — до шести карточек с названием, описанием, языком и звёздами.
- График активности — те самые зелёные квадратики.
Первые три пункта полностью под вашим контролем, и именно они формируют впечатление за первые секунды.
Profile README
Это специальный репозиторий, название которого совпадает с вашим логином: для пользователя ivanov-dev — репозиторий ivanov-dev/ivanov-dev. Он должен быть публичным и содержать README.md в корне. GitHub сам подскажет при создании, что репозиторий «особенный».
Главная ошибка — превратить README в витрину: десяток бейджей технологий, анимированные баннеры, счётчики посетителей, графики языков, «змейка», поедающая квадратики. Выглядит ярко, но информации в этом ноль, а у человека, который пришёл за пятиминутной проверкой, такое вызывает скорее улыбку.
Хороший profile README отвечает на три вопроса: кто вы, что умеете, где посмотреть подтверждения. Шаблон:
## Иван Иванов — backend-разработчик Пишу сервисы на Python и Go, 3 года коммерческой разработки. Сейчас разбираюсь в очередях сообщений и шардировании. **Стек:** Python (FastAPI, asyncio), Go, PostgreSQL, Redis, Docker, Kafka **Что посмотреть:** - [job-aggregator](https://github.com/ivanov-dev/job-aggregator) — агрегатор вакансий: парсинг 4 источников, дедупликация, поиск. ~200 пользователей. - [rate-limiter-go](https://github.com/ivanov-dev/rate-limiter-go) — библиотека ограничения запросов (token bucket, sliding window) с бенчмарками. **Связь:** ivan@example.com · Telegram @ivanov_dev
Десять строк, и у читателя есть всё: специализация, уровень, стек, ссылки и контакт. Стек перечислен текстом — его найдёт и поиск, и глаз, — а не тридцатью картинками-бейджами.
Если хочется добавить что-то личное — доклад, статью, участие в олимпиадах, — одна строка в конце. Если ничего такого нет, не надо. Пустой profile README лучше, чем README из шаблона-генератора с чужими формулировками.
Закреплённые репозитории
По умолчанию GitHub показывает «популярные» репозитории, и там легко окажутся форк чужого конфига и лабораторная со второго курса. Нажмите Customize your pins и выберите сами: до шести репозиториев или gist'ов.
Как выбирать:
- Под вакансию, а не под историю. Ищете бэкенд — наверх сервис с API и базой, а не игру на Unity трёхлетней давности.
- Свои, а не форки. Форк без ваших коммитов ничего о вас не говорит. Исключение — форк, в котором вы реально что-то сделали, и это видно из описания.
- Лучше три, чем шесть. Шесть пунктов, из которых три слабые, тянут вниз сильные. Пустые слоты никто не считает.
- С описанием. У каждого репозитория есть поле About: одна строка, что это и зачем. Без неё карточка — просто непонятное название. Там же добавьте topics (
fastapi,postgresql) и ссылку на демо, если оно есть.
Порядок тоже важен: первая карточка — самая сильная работа.
Пет-проекты: что показывать
Тестовые задания и пет-проекты оценивают по одним и тем же признакам, поэтому полезно смотреть на свой репозиторий глазами проверяющего.
Какой проект работает на вас
Сильный пет-проект решает реальную задачу, пусть маленькую: бот, которым пользуетесь вы и друзья, парсер, который экономит вам время, библиотека, которую вы подключаете в другом проекте. Это видно сразу: в README есть «зачем», а в коде — следы реального использования, обработка ошибок, конфигурация.
Слабый проект — копия курса или туториала: todo-лист, погодное приложение по API, клон интернет-магазина с одинаковой у всех выпускников структурой. Сами по себе они не плохи как учебные упражнения, но в портфолио их узнают с первого взгляда. Если такой проект — ваш единственный, доработайте его так, чтобы он перестал быть «как у всех»: добавьте авторизацию, кэширование, тесты, деплой, нестандартную фичу.
README проекта
README — это первое и часто единственное, что откроют в репозитории. Минимальный набор:
# job-aggregator Собирает вакансии с четырёх сайтов, убирает дубликаты и даёт искать по фильтрам.  ## Возможности - парсинг по расписанию (Celery), 4 источника - дедупликация по нечёткому совпадению заголовков - полнотекстовый поиск в PostgreSQL ## Запуск cp .env.example .env docker compose up Открыть http://localhost:8000/docs ## Стек Python 3.12, FastAPI, PostgreSQL, Celery, Redis, Docker ## Что можно улучшить - вынести парсеры в отдельный сервис - добавить кэширование результатов поиска
Раздел «Что можно улучшить» особенно ценен: он показывает, что вы видите ограничения своего решения. На собеседовании с него удобно начать разговор, и вопрос «а что бы вы переделали» уже не застанет врасплох.
Проверьте, что инструкция по запуску действительно работает: склонируйте репозиторий в чистую папку и выполните её по шагам. Проект, который не собирается по собственному README, производит худшее впечатление, чем отсутствие проекта.
Код и история
Тимлид, открывший репозиторий, за пару минут обратит внимание на:
- структуру — понятно ли, где что лежит, или всё в одном
main.pyна 1500 строк; - тесты — хотя бы несколько на ключевую логику и команду для запуска;
- историю коммитов — осмысленные сообщения вместо
fix,fix2,asdf,final_final; - мусор в репозитории —
node_modules,__pycache__,.idea,.DS_Store, дампы базы; - CI — зелёная галочка GitHub Actions с линтером и тестами — простой и заметный плюс.
Всё это не требует больших усилий, но отличает «умеет работать в команде» от «пишет для себя». Если с Git вы на «вы», пригодится шпаргалка по командам Git.
Что лучше не показывать
Здесь ошибки стоят дороже всего: плохой README снижает впечатление, а утёкший ключ или чужой код может стоить оффера.
Секреты в истории
Самая частая и опасная проблема — ключи API, пароли от базы и токены, закоммиченные в .env или прямо в код. Удалить файл новым коммитом недостаточно: он остаётся в истории, и его видно любому, кто откроет старый коммит. Автоматические сканеры ищут такие ключи в публичных репозиториях постоянно.
Проверить, не было ли в истории файла .env или строки с ключом:
# коммиты, в которых когда-либо менялся .env git log --all --oneline -- .env # коммиты, где добавлялась или удалялась строка с API_KEY git log --all -p -S "API_KEY"
Если что-то нашлось, порядок такой: сначала отозвать и перевыпустить ключ у сервиса — он уже скомпрометирован, — и только потом чистить историю (например, git filter-repo) или пересоздавать репозиторий. Чистка истории без отзыва ключа ничего не решает: копии уже могли сохранить.
На будущее — .gitignore до первого коммита и .env.example с пустыми значениями вместо настоящего .env.
Почта в коммитах
Каждый коммит хранит почту автора, и в публичном репозитории её видно всем. Если в коммитах светится личная или рабочая почта, которую вы не хотите раскрывать, включите в настройках GitHub скрытие адреса и используйте выданный GitHub noreply-адрес в git config user.email. Посмотреть, какие адреса уже есть в истории репозитория:
git log --format='%ae' | sort -u
Код работодателя
Никогда не выкладывайте код с текущей или прошлой работы, даже «обезличенный» и даже если проект закрылся. Это почти наверняка нарушение договора или NDA, и для нанимающей стороны это сильный сигнал: человек, который вынес код прошлой компании, вынесет и наш. Рассказать о рабочем проекте можно на собеседовании словами, без исходников.
Решения тестовых заданий
Многие компании используют одно тестовое годами и прямо просят не публиковать решения. Если просили — не публикуйте. Если не просили, всё равно уберите из названия и описания имя компании: репозиторий yandex-test-task выглядит как подсказка следующим кандидатам и может задеть компанию, в которую вы, возможно, ещё захотите вернуться.
Учебный мусор
Репозитории test, test2, lab3, python-course-hw, копии чужих проектов, брошенные после первого коммита заготовки — всё это лучше сделать приватными или заархивировать (кнопка Archive в настройках репозитория помечает его как неподдерживаемый). Удалять необязательно: приватный репозиторий никому не мешает и остаётся вам на память.
Прочее
- Резкие комментарии в чужих issue и pull request'ах. Профиль показывает и вашу активность в чужих проектах; спор на повышенных тонах в трекере может найтись.
- Нецензурные сообщения коммитов и названия переменных в духе «шутки для своих».
- Проекты, противоречащие резюме: если вы заявляете себя фронтендером, а наверху лежат только скрипты для парсинга, переставьте акценты.
Зелёные квадратики
График активности переоценён. Его легко накрутить пустыми коммитами по расписанию, и опытные интервьюеры это знают. Сплошная зелень говорит скорее о том, что человек следит за графиком, чем о качестве его кода.
Практические моменты:
- Коммиты в приватные репозитории можно показывать на графике анонимно — без названий проектов. Для этого в настройках профиля есть опция включения приватных контрибуций. Если вы активно пишете в закрытых репозиториях, включите её, и график перестанет выглядеть пустым.
- Коммиты попадают в график, только если почта в коммите привязана к вашему аккаунту. Если квадратики не появляются, проверьте
git config user.email. - Не накручивайте. Сотни однотипных коммитов «update README» по одному в день видны при первом же клике.
Опенсорс
Вклад в чужие проекты ценится выше собственных пет-проектов: он показывает, что вы умеете читать чужой код, следовать правилам проекта и проходить код-ревью. Но и здесь качество важнее количества.
С чего начать:
- Проекты, которыми вы пользуетесь. Вы уже знаете, где у них неудобно, и мотивация есть.
- Задачи с метками
good first issue,help wanted. Многие проекты специально размечают задачи для новичков. - Документация, тесты, воспроизведение багов. Это полноценный вклад, и мейнтейнеры его ценят.
Чего не делать: массово отправлять pull request'ы с исправлением опечаток ради галочки в профиле. Мейнтейнеры от такого устают, а интервьюер, открывший список ваших PR, увидит двадцать правок в одну букву.
В резюме опенсорс стоит упомянуть конкретно: «добавил поддержку X в библиотеку Y, PR смёржен» со ссылкой. Это проверяемо и сразу понятно.
Чек-лист перед тем, как ставить ссылку в резюме
- Профиль открыт в инкогнито и выглядит так, как вы задумали.
- Заполнены имя, био одной строкой, контакт.
- Profile README — 5–15 строк: кто, стек, что посмотреть, связь. Без генераторов бейджей.
- Закреплены 2–6 своих репозиториев под целевую вакансию, у каждого есть About.
- У закреплённых проектов есть README с описанием, скриншотом и рабочей инструкцией запуска.
- Проверены история и файлы на ключи, пароли и токены; найденные ключи отозваны.
- Нет кода работодателя и решений тестовых с названием компании.
- Учебные и брошенные репозитории сделаны приватными или заархивированы.
- Стек в профиле не противоречит резюме.
- Ссылка на профиль в резюме ведёт на профиль, а не на случайный репозиторий.
Итоги
- GitHub — не главный документ, а подтверждение резюме. Решающим он бывает у джунов и при смене стека.
- Смотрят его недолго, поэтому значение имеют первые экраны: profile README, закреплённые проекты, их README.
- Два-три доведённых до ума проекта с тестами и инструкцией запуска сильнее десятков заброшенных.
- Главные риски — секреты в истории и чужой код. Их проверить и убрать важнее, чем украсить профиль.
- Зелёные квадратики и бейджи почти ничего не решают; честный, аккуратный профиль решает больше.
- Если показывать нечего, лучше не ставить ссылку, чем ставить ссылку на пустоту, и вложить время в поиск работы через рекомендации или проект, который потом можно будет показать.