Comment commencer à contribuer à un projet de décompilation

Choisissez une cible qui vous intéresse et une tâche dont vous pourrez vérifier le résultat. Il n’est pas nécessaire de commencer par une fonction difficile : reproduire une compilation, préciser une instruction ou documenter un test peut aider le prochain contributeur.

Trouvez un projet, puis fiez-vous à sa documentation pour les outils, branches et règles. DecompHub ne distribue pas de tâches et ne parle pas au nom des responsables.

Vérifier les prérequis

Je peux aider permet d’indiquer macOS, Windows ou Linux. Ces préférences privées facilitent la recherche sans garantir qu’un dépôt fonctionnera sur votre machine.

Vérifiez système, compilateur et révision exacte. Super Mario 64 distingue notamment les procédures Linux, macOS et conteneurisées, ainsi que les données propres aux versions. Une procédure d’un autre fork peut viser le mauvais binaire.

Notez le commit et les versions des outils. Si des données originales ou un appareil précis sont requis, vérifiez-le avant de choisir une tâche. Le catalogue ne les fournit pas.

Lire les règles

Consultez CONTRIBUTING, la documentation et le processus de revue. GitHub explique où apparaissent les consignes de contribution.

Le projet peut exiger un ticket préalable, une branche, un format ou une commande de validation. Respectez aussi sa politique sur le travail généré par IA. Une tâche initiale doit avoir une fin vérifiable : compilation réussie, fonction correspondante, instruction corrigée ou cas reproduisant un défaut.

Établir une référence

Exécutez la validation avant toute modification. Conservez commande, cible, versions et résultat. Si la base échoue déjà, isolez ce problème au lieu de l’attribuer à votre changement.

Un rapport utile décrit résultat attendu, résultat observé et étapes minimales. N’ajoutez que les journaux nécessaires. « Cette commande échoue ici avec cette version » aide davantage qu’un simple « ça ne marche pas ».

Apporter une preuve utile

• Documentation : corrigez une étape testée, un prérequis ambigu ou un lien vers les instructions officielles.
• Tests : suivez une procédure publiée et consignez version et résultat reproductible.
• Code correspondant : commencez par une petite fonction comprise. decomp.me permet d’expérimenter sur la sortie du compilateur, avant la validation dans le dépôt.
• Outillage : améliorez une opération répétable ou un message d’erreur précis, en conservant les contrôles du projet.

objdiff documente un autre workflow de comparaison. Utilisez l’outillage demandé plutôt que d’introduire un second ensemble par habitude.

Proposer un changement ciblé

Expliquez problème, résultat et vérification. Précisez cible et comparaison pour du code, ou instructions réellement suivies pour la documentation. Dites ce qui reste non testé.

Évitez une vaste réorganisation sans rapport avec la tâche. Un changement limité facilite l’examen. Si le dépôt est calme ou archivé, cherchez un successeur documenté avant de supposer qu’une revue sera disponible.

Proposez l’URL officielle si le projet manque. Consultez le guide de progression pour interpréter les chiffres rencontrés.