Портфолио/ссылки/GitHub: как оформить

Коротко. Рекрутер откроет вашу ссылку на 30 секунд, тимлид — на 3 минуты. За это время они должны увидеть: аккуратный профиль, 2–3 закреплённых репозитория с человеческими README и живые демо. Всё остальное — форки, курсовые черновики, «hello world» — прячьте. Какие проекты делать — первые проекты для портфолио и 3 проекта, что показать нанимателю.

Правило 30 секунд

Проверьте своё портфолио чужими глазами: откройте профиль в инкогнито и за 30 секунд ответьте: понятно ли, кто вы (роль)? видно ли лучшие работы (закреплены)? можно ли потрогать (демо в один клик)? Если хотя бы одно «нет» — ссылка в резюме работает против вас: беспорядок в профиле читается как беспорядок в работе.

Профиль GitHub: что видно сразу

• Имя и фото — реальные: профиль соотносят с резюме; ник-аноним с аватаром-мемом мешает.
• Bio одной строкой: «Junior Frontend (React/TS). Открыт к предложениям» + город/удалёнка.
• Закреплённые репозитории (pinned): ровно 2–4 лучших. Это единственное, что реально смотрят.
• Профильный README (репозиторий с именем аккаунта): краткое «кто я, стек, проекты со ссылками». 15 минут работы, выделяет из потока.
• Зелёная активность — приятный бонус, но её не «рисуют» пустыми коммитами: коммиты ради графика видны и дискредитируют.
• Форки и заброшенные эксперименты — в архив (Settings → Archive) или приватные.

Репозиторий проекта: анатомия

• Название и описание: tasks-api + «REST API задач: FastAPI, PostgreSQL, JWT, Docker» — а не project1 без описания.
• Структура: логичные папки, без node_modules и .env в репозитории (утечка секретов в публичном репо — мгновенный красный флаг).
• Коммиты: осмысленные сообщения («add JWT auth», а не «fix» ×40). Историю читают, чтобы понять, как вы думаете.
• Код: единый стиль (линтер!), без гигантских закомментированных кусков, без паролей в коде.
• Теги/релиз не обязательны, но CI-бейдж (тесты проходят) — сильный сигнал зрелости для джуна.

README, который продаёт

Шаблон, закрывающий вопросы за 30 секунд:

# Название проекта
Одно предложение: что делает и для кого.

## Демо
Ссылка на живое демо + скриншот/GIF (обязательно!)

## Стек
React, TypeScript, Vite, TanStack Query

## Возможности
- 3–6 пунктов реальной функциональности

## Запуск
docker compose up  (или npm i && npm run dev)

## Чему научился
2–3 честных пункта: что было сложно и как решил

Блок «Чему научился» недооценён: он превращает учебный проект в историю для собеседования и даёт интервьюеру готовый вопрос, на который вы блестяще ответите.

Живое демо: где хостить бесплатно

Демо должно работать в момент отклика: перед волной откликов прокликайте все ссылки — упавшее демо хуже его отсутствия.

Что показывать по ролям

• Frontend: 2–3 демо с адаптивом и обработкой состояний загрузки/ошибок; Lighthouse 90+ — упомянуть в README.
• Backend: API с README-примерами запросов (curl/Postman-коллекция), тесты, Docker, деплой.
• QA: репозиторий с тест-кейсами/чек-листами (markdown), баг-репорты, Postman-коллекция, 5–10 автотестов Playwright.
• DevOps: «инфраструктура кодом»: Dockerfile + CI/CD-пайплайн + Terraform; README со схемой архитектуры.
• Аналитика: 2 кейс-стади (ноутбук + выводы) и ссылка на публичный дашборд.

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

• ❌ Ссылка на профиль с 30 репозиториями без pinned — рекрутер не будет искать лучшее сам.
• ❌ README на английском при отклике в русскую компанию «для солидности» с ошибками — пишите на языке, на котором говорите свободно, или на двух.
• ❌ Пустые описания репозиториев и дефолтные названия.
• ❌ Секреты в коде: токены, пароли, .env. Проверьте историю коммитов — удаление файла не удаляет его из истории.
• ❌ 100% кода из туториала без единого своего изменения — спалится на первом же вопросе «а почему тут так?».
• ❌ Ссылка в резюме на github.com (главную) вместо своего профиля — случается чаще, чем кажется.

Частые вопросы

Сколько проектов нужно в портфолио джуна?
2–3 доведённых до демо. Один сильный проект с тестами, Docker и деплоем весит больше пяти черновиков.

Смотрят ли вообще GitHub?
Рекрутер — 30 секунд (аккуратность), тимлид перед собесом — почти всегда, если ссылка на виду. На собесе проект часто становится главной темой — это ваша домашняя территория.

Нужен ли сайт-портфолио отдельно от GitHub?
Фронтендеру — полезен (он сам — демо навыков). Остальным хватает профиля GitHub с README и живых демо.

Что делать, если проекты — с курсов и у всех одинаковые?
Дорабатывать: +2–3 своих фичи, свой дизайн, тесты, деплой. В README честно: «база — курсовой проект, самостоятельно добавлено: …». Это уже отличает вас от копий.

GitLab или GitHub?
Для витрины — GitHub (его открывают по привычке). Умение работать с GitLab упомяните в навыках — в РФ он частый рабочий инструмент.