CONTRIBUTING.md

CONTRIBUTING

Спасибо за интерес к каталогу хактоны.

Этот репозиторий собирает и поддерживает актуальную информацию о хакатонах 2026 года на русском языке.

Что можно улучшать

• добавлять новые подтвержденные хакатоны;
• обновлять даты, дедлайны и ссылки;
• исправлять ошибки и неточности;
• расширять индексы по странам и форматам;
• уточнять призовой фонд, правила и формат участия.

Главные правила

• Используйте только официальные источники.
• Не добавляйте неподтвержденные данные как факт.
• Если поле неизвестно, пишите это явно.
• Не дублируйте одну и ту же карточку в нескольких местах.
• Индексные страницы не должны содержать события без карточки.
• Язык описания — русский.
• Не добавляйте идеи для проектов: каталог хранит только сведения о событиях.

Как добавить новый хакатон

1. Скопируйте templates/hackathon-template.md.
2. Заполните карточку по официальной странице.
3. Сохраните файл в папке нужного месяца внутри hackathons/2026/.
4. Добавьте ссылку в нужные индексы.
5. Если дедлайн близкий, обновите indexes/deadlines/nearest.md.

Формат данных

• Формат дат: YYYY-MM-DD, если точная дата известна.
• Если точная дата не опубликована, пишите не указано или уточняется.
• Для ссылок используйте полные URL.
• Не используйте рекламные формулировки.
• Для неизвестных значений лучше писать не указано на официальной странице, чем оставлять поле пустым.

Что желательно указать

• название;
• организатор;
• страна и город;
• формат участия;
• даты проведения;
• дедлайн регистрации и сабмита, если известны;
• призовой фонд;
• официальный сайт;
• правила;
• дата последней проверки;
• качество данных.

Проверка перед обновлением

• данные подтверждены официальным источником;
• ссылки открываются;
• формат карточки не сломан;
• индексные страницы синхронизированы;
• в тексте нет вымышленных деталей.