GitHub: портфолио разработчика

GitHub-профиль и публичные репозитории — публичное лицо разработчика, которое смотрят рекрутеры и работодатели при найме.

Зачем нужно

GitHub-портфолио — это возможность показать реальный код, а не перечислять технологии в резюме. Активный профиль с качественными проектами, README и contrib-историей даёт преимущество при найме. Даже небольшие pet-проекты, оформленные профессионально, говорят о навыках больше, чем сертификаты.

Где используется

  • Скрининг резюме: рекрутеры и тимлиды проверяют GitHub первым делом
  • Open-source участие: contributions в популярные проекты
  • Демонстрация навыков при выполнении тестовых заданий
  • Документация собственных инструментов и библиотек

Основной контент

Профиль и README

# Создать специальный репозиторий-профиль (имя совпадает с логином)
# GitHub автоматически показывает README.md этого репо на странице профиля

# Структура profile README.md:
# - Краткое описание кто ты и чем занимаешься
# - Стек технологий (badges или иконки)
# - Ссылки на лучшие проекты
# - Контакты (email, LinkedIn, Telegram)

Оформление репозитория проекта

project-repo/
├── README.md          ← описание, установка, примеры
├── LICENSE            ← MIT, Apache, GPL и т.п.
├── .gitignore         ← исключённые файлы
├── CONTRIBUTING.md    ← как участвовать (для open-source)
└── src/               ← код

Хороший README содержит:

  • Название и одно предложение что это
  • Скриншот или GIF демонстрации (если есть UI)
  • Раздел Installation (как запустить за 3 команды)
  • Раздел Usage (примеры использования)
  • Стек технологий
  • Ссылка на деплой/демо

Коммиты и contrib-график

# Contrib-график (зелёные квадраты) учитывает:
# - Коммиты в репозитории где ты contributor
# - Открытые Issues и Pull Requests
# - Ревью Pull Requests

# Практики для активного графика:
# - Коммиты в публичные репозитории, а не только приватные
# - Участие в open-source (даже документация считается)
# - Собственные pet-проекты

# Проверить email в настройках — коммиты засчитываются
# только если email в коммите совпадает с email аккаунта
git config user.email
git config --global user.email "your@email.com"

Topics и описание репозитория

# Через GitHub UI добавить:
# - Description: одна строка что делает проект
# - Website: ссылка на деплой
# - Topics: javascript, react, nodejs, rest-api
# (теги помогают находить проект по теме)

Закреплённые репозитории (Pinned)

На странице профиля можно закрепить до 6 репозиториев. Стратегия выбора:

  • 2-3 полноценных проекта с хорошим README и деплоем
  • 1-2 демонстрирующих владение конкретными технологиями
  • Участие в open-source (если есть)

Contributing в open-source

# 1. Найти репозиторий с меткой "good first issue"
# 2. Fork репозитория
git fork  # через GitHub UI

# 3. Клонировать свой fork
git clone https://github.com/YOUR/repo.git
cd repo

# 4. Добавить upstream
git remote add upstream https://github.com/ORIGINAL/repo.git

# 5. Создать ветку, внести изменение
git switch -c fix/typo-in-readme

# 6. Отправить в свой fork и создать PR в оригинальный проект
git push -u origin fix/typo-in-readme

Частые ошибки

  • Пустые репозитории без README — проект без описания выглядит заброшенным; хотя бы 3-4 предложения о том, что это
  • Приватные коммиты не отображаются — contrib-график не засчитывает коммиты в приватные репозитории (если не включена настройка)
  • Fork без коммитов — форки без собственных изменений не говорят о навыках
  • Отсутствие .gitignore — node_modules/ или .env в репозитории — красный флаг для работодателя

Связанные темы

Ресурсы