Jak zacząć współtworzyć projekt dekompilacji

Wybierz interesujący cel i zadanie, którego wynik potrafisz sprawdzić. Nie musisz zaczynać od trudnej funkcji. Powtórzenie kompilacji, doprecyzowanie wymagania lub dobry raport testowy pomaga następnym osobom.

Znajdź projekt, a narzędzia, gałęzie i zasady dobierz według jego dokumentacji. DecompHub nie przydziela zadań i nie reprezentuje opiekunów.

Sprawdź środowisko

Mogę pomóc uwzględnia macOS, Windows i Linux. To prywatne preferencje dopasowania, a nie gwarancja działania repozytorium na Twoim komputerze.

Zweryfikuj system, kompilator i dokładną rewizję. Super Mario 64 rozróżnia konfiguracje dla Linuksa, macOS i kontenerów oraz dane wymagane przez wersje. Instrukcja dla innego forka może prowadzić do porównania z niewłaściwym celem.

Zapisz commit i wersje narzędzi. Ustal wcześniej wymagane oryginalne dane lub sprzęt; katalog ich nie dostarcza.

Przeczytaj zasady

Sprawdź CONTRIBUTING, dokumentację i procedurę przeglądu. GitHub wyjaśnia, gdzie znajdują się wytyczne.

Projekt może wymagać wcześniejszego zgłoszenia, konkretnej gałęzi, formatowania lub walidacji. Respektuj też politykę dotyczącą AI. Dobre pierwsze zadanie ma jasny koniec: udany build, zgodna funkcja, poprawiona instrukcja lub odtworzony błąd.

Ustal stan początkowy

Uruchom walidację przed edycją. Zachowaj polecenie, wersję celu, narzędzia i wynik. Jeśli stan początkowy nie działa, potraktuj ten problem osobno.

Raport powinien opisywać oczekiwany i faktyczny wynik oraz minimalne kroki odtworzenia. Dodawaj tylko potrzebne logi. Konkretne polecenie, etap i wersja są przydatniejsze niż samo „nie działa”.

Wkład poparty dowodami

• Dokumentacja: popraw przetestowany krok, niejasne wymaganie lub oficjalny odsyłacz.
• Testy: wykonaj opublikowaną procedurę i zapisz wersję oraz powtarzalny wynik.
• Zgodny kod: zacznij od małej zrozumianej funkcji. decomp.me pozwala eksperymentować z kompilatorem; potem obowiązują kontrole projektu.
• Narzędzia: ulepsz powtarzalny proces lub komunikat błędu, zachowując wymagane sprawdzenia.

objdiff opisuje inny proces porównywania. Używaj narzędzi wskazanych przez projekt, zamiast dodawać drugi zestaw z przyzwyczajenia.

Zaproponuj małą zmianę

Wyjaśnij problem, nowe zachowanie i sposób sprawdzenia. Dla matchingu podaj cel i porównanie, a dla dokumentacji — przetestowane kroki. Wymień rzeczy niesprawdzone.

Nie łącz pierwszego wkładu z ogólnymi porządkami. Małe, udokumentowane zmiany ułatwiają przegląd. Przy cichym lub zarchiwizowanym repozytorium poszukaj oficjalnego następcy, zanim założysz dostępność recenzenta.

Zgłoś oficjalny URL, jeśli projektu brakuje. Poradnik o postępie wyjaśnia jego liczby.