Como interpretar relatórios de progresso de descompilação

Um percentual precisa de contexto: o que é contado, para qual compilação e em que data. O DecompHub mantém rótulo, escopo e fonte. Sem uma medição confiável, o progresso fica desconhecido. Isso não significa zero.

Correspondência e funcionamento

A descompilação com correspondência binária busca gerar o mesmo código de máquina de uma compilação original. Compilador e configurações importam tanto quanto o código reconstruído. O FAQ do decomp.me explica comparações por função. Um resultado isolado não mede o jogo inteiro.

Um substituto compatível reproduz comportamento. O ScummVM substitui executáveis usando dados dos jogos. Seu suporte não é um percentual de código correspondente. Ports e pesquisa de hardware podem ser úteis sem publicar esse indicador.

Confira o denominador

Relatórios podem contar funções, bytes, arquivos, símbolos ou recursos identificados. Em um exemplo hipotético, 900 funções correspondentes de 1.000 representam 90% por função. Se as restantes contêm metade dos bytes de código, não são 90% por bytes. Esse exemplo não é uma medição real do catálogo.

Verifique indicador, unidade, escopo e fonte. Uma contagem só vira percentual se houver um total documentado. Biblioteca, região e executável completo são escopos diferentes.

O objdiff documenta ferramentas de comparação e geração de relatórios. A presença da ferramenta não define automaticamente configuração nem denominador do projeto.

Separe versões e recursos

Um jogo pode ter regiões, revisões e compilações de depuração. Completar uma não demonstra que todas foram concluídas. Ocarina of Time documenta versões e seleção do alvo.

Código correspondente e recursos identificados também são trabalhos separados. Concluir código não significa entender todas as texturas, sons e estruturas. Não tire uma média, a menos que o projeto defina explicitamente esse indicador agregado.

Distinga as datas

A data do relatório vem do responsável pela medição. A data de observação indica quando o DecompHub leu a fonte: uma leitura recente pode encontrar um resultado antigo. Atualizar a ficha ou consultar o repositório não atualiza a medição.

A documentação dos dados explica os campos. Ao citar, mantenha projeto, indicador, escopo, URL e tipo de data juntos.

Não invente valores ausentes

Desconhecido pode significar formato incompatível, fonte indisponível, escopo ambíguo ou coleta pendente. Não prova ausência de trabalho. Valores acima de 100%, denominadores variáveis e badges contraditórios exigem verificação, não correção silenciosa ou substituição por estrelas.

Veja projetos com progresso registrado e compare medidas equivalentes. Informe erros pela ficha com a evidência original.