Как начать участвовать в проекте декомпиляции

Начните с интересной цели и задачи, результат которой можно проверить. Первый вклад не обязан быть сложной matching-функцией. Повторение сборки, уточнение инструкции или точный отчёт об ошибке тоже полезны.

Найдите проект и следуйте его документации по инструментам, веткам и правилам участия. DecompHub не назначает задачи и не выступает от имени сопровождающих.

Проверьте окружение

В «Могу помочь» можно указать доступные macOS, Windows и Linux. Это приватные предпочтения для подбора, а не гарантия совместимости сборки.

Уточните ОС, компилятор и целевую версию. Super Mario 64 отдельно описывает Linux, macOS, контейнеры и входные данные версий. Инструкция другого форка может привести к сборке для неподходящей цели.

Запишите коммит и версии инструментов. Заранее выясните, нужны ли оригинальные данные игры или устройство. Каталог не предоставляет оригинальные программы и ресурсы.

Прочитайте правила участия

Найдите CONTRIBUTING, документацию и порядок проверки изменений. GitHub объясняет размещение таких правил.

Проверьте, нужны ли предварительный issue, конкретная ветка, форматирование или особая команда проверки. Соблюдайте политику проекта в отношении работ, созданных с помощью ИИ.

У хорошей первой задачи есть понятное завершение: сборка проходит, одна функция совпадает, инструкция исправлена или ошибка воспроизведена.

Зафиксируйте исходное состояние

До правок выполните документированную проверку. Сохраните команду, цель, версии инструментов и результат. Если исходная сборка уже падает, отделите эту проблему от последующего изменения.

В отчёте укажите ожидание, фактический результат и минимальные шаги воспроизведения. Добавляйте только относящиеся к сбою журналы. Точная ошибка команды полезнее общего «проект не работает».

Выберите небольшой вклад

• Документация: исправьте проверенный шаг, неоднозначное требование или ссылку.
• Тестирование: выполните опубликованную процедуру на доступной системе, записав версию.
• Matching-код: начните с небольшой понятной функции. decomp.me подходит для экспериментов; успех всё равно нужно проверить внутри проекта.
• Инструменты: улучшите повторяемый процесс или сообщение об ошибке, сохранив ожидаемое поведение.

objdiff описывает локальное сравнение. Используйте инструменты выбранного репозитория, а не добавляйте второй стек без необходимости.

Отправьте сфокусированное изменение

Объясните проблему, новое поведение и проверку. Для matching назовите цель и сравнение; для документации — выполненные шаги. Прямо отметьте непроверенное.

Не превращайте первый вклад в уборку несвязанных файлов. Если проект тихий или архивный, ищите указанного авторами преемника. Отсутствующий репозиторий можно предложить каталогу. Разобраться в измерениях поможет руководство по прогрессу.