Как описать хакатон в портфолио и показать свой вклад
Как превратить проект хакатона в понятный кейс: показать личный вклад, рабочий результат, ограничения и ссылки на материалы.
·4 мин чтения
Кейс хакатона в портфолио должен показывать задачу, ваши решения и результат, который можно проверить. Укажите свою роль отдельно от работы всей команды. Призовое место добавляйте только с подтверждением; отсутствие награды не мешает описать содержательную инженерную или продуктовую работу.
Читатель не обязан открывать весь репозиторий, чтобы понять ваш вклад. В начале дайте короткий контекст: формат события, длительность, состав команды и состояние проекта на финале. Затем переходите к одному или двум решениям, за которые отвечали лично.
Выберите угол рассказа под свою роль
Разработчику полезно объяснить реализованный сценарий, интеграцию и способ проверки. Дизайнеру стоит показать пользовательскую задачу, ограничения интерфейса и изменения после наблюдения. Аналитику помогут происхождение данных, проверенные предположения и разбор ошибок.
Не пытайтесь одинаково подробно описать все части. Если вы отвечали за дизайн, список серверных библиотек сам по себе не раскрывает работу. Лучше показать, как изменили порядок действий после того, как участники теста не нашли результат операции.
Для перехода в новую роль выбирайте материал, где виден соответствующий навык. При этом сохраняйте точность авторства. Помощь в обсуждении архитектуры и самостоятельная реализация серверной части представляют разный вклад и должны называться по-разному.
Начните с конкретного контекста
Первый абзац может отвечать на четыре вопроса: для кого создавался проект, какую задачу решал, сколько времени было у команды и что делали вы. Например: «На учебном хакатоне наша команда собрала прототип распределения обращений. Я отвечал за загрузку файлов и интерфейс проверки предложенной категории».
Это пример формулировки, а не готовое описание вашего опыта. Замените все детали фактами собственного проекта. Не добавляйте клиентов, число пользователей и экономию времени, если их не было в исследовании.
Если кейс связан с закрытыми материалами, заранее согласуйте, что можно показать. При необходимости используйте обезличенные или искусственные примеры и подпишите их. Замена данных должна сохранять смысл решения, не создавая ложного впечатления реального внедрения.
Покажите решение и причину выбора
Опишите исходную трудность, рассмотренный вариант и принятое решение. Для короткого события причина часто связана со сроком, доступными навыками или ограничением API. Это нормальный контекст, если объяснить последствия выбора.
Например, команда отказалась от автоматического назначения обращений и оставила подтверждение координатору, потому что проверка выявила неоднозначные сообщения. В кейсе можно показать экран до изменения, новое действие и наблюдение, которое привело к решению.
Не придумывайте задним числом сложный процесс исследования. Если выбор сделали по предположению и не успели проверить, так и напишите. Затем обозначьте, как проверили бы его при продолжении проекта. Такая граница делает рассказ точнее.
Подберите доказательства для каждого вывода
Для технической работы подойдут ссылка на понятный фрагмент кода, схема взаимодействия и воспроизводимая инструкция запуска. Для интерфейса полезна короткая запись сценария. Для анализа данных покажите метод, источник и пример ошибки, а не только удачный график.
Результат «собрали работающий прототип» лучше уточнить. Какие действия доступны? На каких данных он проверен? Кто запускал его вне команды? Если таких проверок не было, не называйте проект внедрённым или готовым к промышленной эксплуатации.
Метрики сопровождайте условиями измерения. Время одного прохода на подготовленном примере не доказывает экономию для организации. Можно честно написать, что измерили демонстрационный сценарий и что ещё нужно проверить на реальной работе.
Сделайте материалы доступными
Откройте все ссылки без своего аккаунта. Убедитесь, что изображения читаются на телефоне, видео воспроизводится и репозиторий содержит объяснение проекта. Если демонстрационный сервер выключен, уберите кнопку, которая обещает живой запуск, или замените её ссылкой на запись с ясной подписью.
GitHub позволяет использовать README для объяснения назначения проекта и начала работы; структура описана в официальной документации о README. Для кейса добавьте туда также границы готовности и ваш вклад, если это общий командный репозиторий.
Не выкладывайте секреты, внутренние адреса и чужие персональные данные ради убедительного скриншота. Доказательство должно показывать решение задачи. Лишние сведения на рабочем экране не добавляют ценности читателю.
Пример структуры кейса
Можно собрать одну страницу в таком порядке:
Задача и контекст события.
Моя роль и граница ответственности.
Основное решение с иллюстрацией или коротким видео.
Проверка: способ, наблюдения и ограничения.
Итоговое состояние проекта и дальнейшая работа.
Ссылки на код, демо и подтверждение награды, если она была.
Не превращайте каждый пункт в одинаковую по длине главу. Главному решению может понадобиться несколько абзацев, а контексту достаточно трёх предложений. Если материал длинный, поставьте работающий пример ближе к началу.
Обновите кейс после продолжения проекта
Если после финала вы исправили запуск, изменили алгоритм или провели дополнительные проверки, отделите этот этап от работы на событии. Иначе читатель не поймёт, что было сделано за время хакатона, а что появилось позже.
Укажите дату последней содержательной правки и текущее состояние демо. Периодически проверяйте внешние ссылки. Кейс с честно подписанной архивной записью полезнее страницы, где каждая кнопка ведёт к отключённому сервису.
Перед публикацией отправьте текст товарищам по команде для проверки авторства и фактов. Это особенно полезно, если роли пересекались. Планировать следующий этап разработки поможет отдельный материал о проекте после хакатона.
Ищете задачу для следующего кейса? Посмотрите хакатоны в каталоге Stavleak и выберите событие, на котором сможете показать нужный вам навык.
