Reportar um Bug
Como você pode reportar um bug para que ele seja revisado e corrigido
Se você encontrar quaisquer bugs ou problemas com o SDK do Decentraland e o Scene Editor no Creator Hub, por favor reporte-os no nosso repositório do GitHub aqui.
Antes de reportar um bug
Antes de enviar um relatório de bug, por favor garanta o seguinte:
Certifique-se de que está usando a versão mais recente do SDK, caso o problema já tenha sido corrigido em versões mais novas.
Verifique a documentação da funcionalidade que você está tentando usar, para confirmar que ela deveria se comportar como você espera e que isso não é apenas um mal-entendido.
Descartar que o problema possa ser causado por como sua cena foi construída. Veja Depurar no Preview e Depurar em Prod para dicas.
Evite duplicatas. Verifique a lista de bugs conhecidos para evitar criar uma duplicata. Se você tiver mais informações para adicionar a um problema existente, por favor adicione um comentário ao problema em vez de criar um novo.
Reportando um bug
Para reportar um bug no SDK, você precisará de uma conta no GitHub. Siga estes passos:
Visite o seguinte link: Página de Novo Issue
Clique Get Started ao lado de Bug Report.
Preencha todos os campos do template. O template fornece instruções para cada seção. Quanto mais detalhes você puder fornecer, mais rápido nossos desenvolvedores poderão identificar e resolver o problema.
Clique Enviar novo issue.
Os desenvolvedores podem fazer perguntas de acompanhamento no seu ticket se precisarem de esclarecimentos ou informações adicionais. Você receberá notificações por e-mail sobre atualizações no seu relatório de bug.
📔 Observação: Para quaisquer problemas não relacionados ao SDK, por favor entre em contato com a equipe de suporte. Para entrar em contato, por favor visite esta página intercom.decentraland.org ou nos envie um e-mail para [email protected]. Você também pode nos encontrar no Discord. A equipe está disponível para ajudar de segunda a domingo, das 12h às 21h UTC e fará o melhor para retornar o contato o mais rápido possível. Você pode esperar uma resposta dentro de 60 minutos no Discord durante esse horário e dentro de 24h por e-mail.
Você também pode contatar a equipe de suporte do DAO no DAO Discord.
Dicas adicionais para relatórios de bugs:
Crie um issue separado para cada bug. Se você encontrar múltiplos problemas, certifique-se de criar um novo issue para cada um.
Evite explicações longas. Inclua apenas saída de linha de comando, console ou código da cena relevantes quando necessário.
Anexe imagens ou vídeos, se possível. Você pode facilmente arrastá-los e soltá-los na área de texto do issue, e o GitHub lidará com o upload e o vínculo.
Usando o Decentraland Playground
Fornecer trechos de código que demonstrem o problema é extremamente útil. Reprodutibilidade é crucial. Se um bug não puder ser reproduzido, é desafiador diagnosticá-lo e corrigi-lo.
Você pode colar trechos de código no texto do seu issue, mas a melhor maneira de fornecer trechos de código é usando o Decentraland Playground. Siga estes passos:
Escreva seu trecho de código na esquerda e veja sua cena no painel direito.
Clique no Share botão e cole o link no seu relatório de issue.
Usar o playground simplifica a reprodução do problema e garante que qualquer pessoa que abrir o link possa ver a mesma saída, independentemente do sistema operacional, versão do SDK, versão do Node, etc. Também facilita iterações rápidas para identificar condições afetadas e localizar a causa do problema.
Mantenha seu exemplo o mais conciso possível, enquanto ainda reproduce o problema. Um exemplo mais simples ajuda a eliminar ambiguidades sobre a origem do problema.
📔 Observação: Não é possível importar assets para sua cena no Playground. Então, se reproduzir o problema requerer importar um modelo 3D ou um arquivo de som, não será possível exibi-lo lá.
Obtendo logs
Frequentemente é útil obter os logs do Explorer do Decentraland ao reportar um bug.
Para obter seus logs, simplesmente abra o chat e escreva /logs. Isso abrirá uma nova janela com os logs do Explorer do Decentraland. Anexe o Player.log arquivo ao seu relatório de issue.
Editando a Documentação
Se você descobrir problemas no conteúdo do site da Documentation, você pode submetê-los como solicitações de alteração. Simplesmente role até o final da página e clique no Edit this page botão. O GitHub irá guiá-lo através da criação de um pull request com suas mudanças. A equipe da fundação revisará suas mudanças e as publicará se forem consideradas úteis.
Solicitações de funcionalidades e sugestões
Se você tiver sugestões para adicionar novas funcionalidades ou recursos em vez de reportar um problema, por favor junte-se ao Decentraland Discord Server e poste uma mensagem no Creator Hub Channel em vez de criar um GitHub Issue.
Atualizado