Як почати допомагати проєкту декомпіляції

Почніть із цікавої вам цілі та завдання, результат якого можна перевірити. Перший внесок не обов’язково має бути складною matching-функцією: перевірене збирання, уточнення інструкції чи точний звіт про помилку теж допомагають.

Знайдіть проєкт і дотримуйтеся його правил щодо інструментів, гілок та внесків. DecompHub не призначає завдань і не представляє супроводжувачів.

Перевірте середовище

У «Можу допомогти» можна вказати доступні macOS, Windows і Linux. Це приватні налаштування підбору, а не гарантія сумісності збирання.

З’ясуйте точні версії ОС, компілятора й цільового випуску. Super Mario 64 окремо описує Linux, macOS, контейнери та вхідні дані для версій. Інструкція іншого форка може дати збірку для неправильної цілі.

Запишіть коміт і версії інструментів. Заздалегідь перевірте, чи потрібні оригінальні дані гри або обладнання. Каталог не надає оригінальних програм і ресурсів.

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

Знайдіть CONTRIBUTING, документацію та порядок перевірки змін. GitHub пояснює, де шукати такі правила.

Перевірте потрібну гілку, форматування, команди валідації, вимогу спершу відкрити issue та політику щодо згенерованого ШІ коду. Правила іншого проєкту тут не діють автоматично.

Хороше перше завдання має чітку умову завершення: збірка проходить, функція збігається, інструкцію виправлено або помилку відтворено.

Зафіксуйте початковий стан

До редагування виконайте документовану перевірку. Збережіть команду, ціль, версії інструментів і результат. Якщо вихідна збірка вже не працює, відокремте цю помилку від своєї зміни.

У звіті опишіть очікування, фактичний результат і мінімальні кроки відтворення. Додайте лише потрібні журнали. Конкретний збій команди корисніший за загальне «нічого не працює».

Оберіть посильний внесок

• Документація: виправте перевірений крок, неоднозначну вимогу або посилання.
• Тестування: виконайте описану процедуру на своєму обладнанні та зафіксуйте версію.
• Matching-код: почніть із невеликої зрозумілої функції. decomp.me допомагає експериментувати; результат усе одно має пройти перевірки проєкту.
• Інструменти: поліпшіть повторювану операцію чи повідомлення про помилку без зміни очікуваної поведінки.

objdiff описує робочий процес порівняння. Використовуйте стек обраного репозиторію.

Подайте вузьку зміну

Поясніть проблему, нову поведінку та спосіб перевірки. Для matching назвіть ціль і порівняння; для документації — пройдені кроки. Неперевірене позначте прямо.

Не додавайте попутне велике прибирання. Якщо репозиторій тихий або архівний, пошукайте задокументованого наступника. Відсутній запис можна подати; значення відсотків пояснює посібник із прогресу.