GitHub-профиль разработчика: портфолио, которое помогает найти работу

Смотрят ли GitHub на собеседовании, как оформить profile README и закреплённые репозитории, какие пет-проекты показывать и что лучше спрятать: ключи, учебный мусор, чужой код.

12 мин чтениякарьера · резюме · github · поиск работы

Коротко

ВопросОтвет
Смотрят ли GitHubчаще всего бегло: 1–3 минуты, и в основном у джунов и при смене стека
Что видят первымprofile README, закреплённые репозитории, README открытого проекта
Сколько проектов нужно2–3 доведённых до конца лучше двадцати заброшенных
Что важнее всего в проектеREADME с описанием, запуском и скриншотом, тесты, внятная история коммитов
Что спрятатьсекреты в истории, копии туториалов, решения тестовых заданий, код работодателя
Зелёные квадратикипочти никого не впечатляют; их отсутствие у мидла с NDA-работой — норма

GitHub не заменяет резюме и не решает исход собеседования. Его задача скромнее: подтвердить то, что написано в резюме, и не дать повода усомниться. Хороший профиль — это пять минут работы рекрутера и тимлида, после которых у них меньше вопросов, а не больше.

Смотрят ли GitHub на самом деле

Честный ответ: смотрят не все и не всегда, а когда смотрят — недолго.

Рекрутер обычно не читает код. Он открывает ссылку, чтобы убедиться, что профиль живой: есть проекты по заявленному стеку, есть описания, нет пустоты. Решение «звать или нет» он принимает по резюме, а GitHub лишь добавляет или снимает очки.

Технический интервьюер или тимлид может открыть один-два репозитория перед созвоном, чтобы задать вопросы по коду. «Почему здесь синхронные запросы к базе?», «Как бы ты это масштабировал?» — такие вопросы по вашему же проекту встречаются на техническом скрининге и в разговорах с тимлидом. Это хороший сценарий: обсуждать свой код проще, чем абстрактные задачи.

Где GitHub весит больше всего:

  • Джуны и стажёры. Опыта работы нет, и проекты — единственное доказательство, что вы умеете довести код до работающего состояния.
  • Смена стека или профессии. Три года на Java и вакансия на Go: репозиторий с сервисом на Go снимает вопрос лучше любого сопроводительного письма.
  • Опенсорс-ориентированные компании и вакансии, где прямо просят ссылку на код.
  • Удалённый найм в зарубежные компании, где кандидата хочется проверить до затратного цикла собеседований.

Где почти не весит: мидлы и сеньоры с подтверждаемым опытом. Их код живёт в закрытых репозиториях работодателя, и это все понимают. Пустой публичный GitHub у человека с пятью годами коммерческой разработки — не красный флаг. А вот ссылка на пустой профиль в резюме — уже небрежность: если показывать нечего, ссылку лучше не ставить.

Профиль не обязан быть идеальным. Он обязан не противоречить резюме. «Senior Python Developer» в резюме и три форка учебных курсов по JavaScript в профиле — вопрос, который вам зададут.

Как профиль выглядит со стороны

Откройте свой профиль в режиме инкогнито — так его видит посторонний человек. Сверху вниз:

  1. Аватар, имя, короткое био, город, ссылки. Фото или нейтральная картинка, настоящее имя или узнаваемый ник, одна строка о себе: «Backend на Python и Go, интересуюсь распределёнными системами». Контакты — почта или Telegram.
  2. Profile README — блок Markdown прямо на странице профиля.
  3. Закреплённые репозитории — до шести карточек с названием, описанием, языком и звёздами.
  4. График активности — те самые зелёные квадратики.

Первые три пункта полностью под вашим контролем, и именно они формируют впечатление за первые секунды.

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 Собирает вакансии с четырёх сайтов, убирает дубликаты и даёт искать по фильтрам. ![Скриншот поиска](docs/screenshot.png) ## Возможности - парсинг по расписанию (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 смёржен» со ссылкой. Это проверяемо и сразу понятно.

Чек-лист перед тем, как ставить ссылку в резюме

  1. Профиль открыт в инкогнито и выглядит так, как вы задумали.
  2. Заполнены имя, био одной строкой, контакт.
  3. Profile README — 5–15 строк: кто, стек, что посмотреть, связь. Без генераторов бейджей.
  4. Закреплены 2–6 своих репозиториев под целевую вакансию, у каждого есть About.
  5. У закреплённых проектов есть README с описанием, скриншотом и рабочей инструкцией запуска.
  6. Проверены история и файлы на ключи, пароли и токены; найденные ключи отозваны.
  7. Нет кода работодателя и решений тестовых с названием компании.
  8. Учебные и брошенные репозитории сделаны приватными или заархивированы.
  9. Стек в профиле не противоречит резюме.
  10. Ссылка на профиль в резюме ведёт на профиль, а не на случайный репозиторий.

Итоги

  • GitHub — не главный документ, а подтверждение резюме. Решающим он бывает у джунов и при смене стека.
  • Смотрят его недолго, поэтому значение имеют первые экраны: profile README, закреплённые проекты, их README.
  • Два-три доведённых до ума проекта с тестами и инструкцией запуска сильнее десятков заброшенных.
  • Главные риски — секреты в истории и чужой код. Их проверить и убрать важнее, чем украсить профиль.
  • Зелёные квадратики и бейджи почти ничего не решают; честный, аккуратный профиль решает больше.
  • Если показывать нечего, лучше не ставить ссылку, чем ставить ссылку на пустоту, и вложить время в поиск работы через рекомендации или проект, который потом можно будет показать.

Потренироваться в спокойной обстановке

Все задачи