Informar un bug
Cómo puedes informar un bug para que se revise y se corrija
Si encuentras algún error o problema con el SDK de Decentraland y el Scene Editor en Creator Hub, por favor repórtalo en nuestro repositorio de GitHub aquí.
Antes de reportar un error
Antes de enviar un informe de error, asegúrate de lo siguiente:
Asegúrate de estar usando la última versión del SDK, por si el problema ya se hubiera corregido en versiones más recientes.
Revisa la documentación de la función que estás tratando de usar, para confirmar que se supone que debe comportarse como esperas y que no se trata solo de un malentendido.
Descarta que el problema pueda estar causado por la forma en que está construida tu scene. Consulta Debug en Preview y Debug en Prod para obtener consejos.
Evita duplicados. Revisa la lista de errores conocidos para evitar crear un duplicado. Si tienes más información para añadir a un issue existente, agrega un comentario al issue en lugar de crear uno nuevo.
Reportar un error
Para reportar un error con el SDK, necesitarás una cuenta de GitHub. Sigue estos pasos:
Visita el siguiente enlace: Página de nuevo issue
Haz clic en Get Started junto a Bug Report.
Completa todos los campos de la plantilla. La plantilla incluye instrucciones para cada sección. Cuantos más detalles puedas proporcionar, más rápido podrán nuestros desarrolladores identificar y resolver el problema.
Haz clic en Enviar nuevo issue.
Es posible que los desarrolladores te hagan preguntas de seguimiento en tu ticket si necesitan aclaraciones o información adicional. Recibirás notificaciones por email sobre las actualizaciones de tu informe de error.
📔 Nota: Para cualquier problema no relacionado con el SDK, contacta al equipo de soporte. Para comunicarte con ellos, visita esta página intercom.decentraland.org o envíanos un email a [email protected]. También puedes encontrarnos en Discord. El equipo está disponible para ayudar de lunes a domingo, de 12pm a 9pm UTC, y hará todo lo posible por responderte lo antes posible. Puedes esperar una respuesta en un plazo de 60 min en Discord durante el horario indicado y en un plazo de 24h por email.
También puedes contactar al equipo de soporte de la DAO en el Discord de la DAO.
Consejos adicionales para informes de errores:
Crea un issue separado para cada error. Si encuentras varios problemas, asegúrate de crear un issue nuevo para cada uno.
Evita las explicaciones extensas. Incluye solo la salida relevante de la línea de comandos o de la consola, o el código de la scene cuando sea necesario.
Adjunta imágenes o videos si es posible. Puedes arrastrarlos y soltarlos fácilmente en el área de texto del issue, y GitHub se encargará de la subida y del enlace.
Usar el Decentraland Playground
Proporcionar fragmentos de código que demuestren el problema es extremadamente útil. La capacidad de reproducción es crucial. Si un error no se puede reproducir, es difícil diagnosticarlo y corregirlo.
Puedes pegar fragmentos de código dentro del texto de tu issue, pero la mejor manera de proporcionar fragmentos de código es usando el Decentraland Playground. Sigue estos pasos:
Escribe tu fragmento de código a la izquierda y visualiza tu scene en el panel derecho.
Haz clic en el botón Share y pega el enlace en tu informe de issue.
Usar el playground simplifica la reproducción del issue y garantiza que cualquiera que abra el enlace pueda ver la misma salida, sin importar su sistema operativo, versión del SDK, versión de Node, etc. También facilita la iteración rápida para identificar las condiciones afectadas y señalar la causa del problema.
Mantén tu ejemplo lo más conciso posible, sin dejar de reproducir el problema. Un ejemplo más simple ayuda a eliminar la ambigüedad sobre el origen del problema.
📔 Nota: No es posible importar assets a tu scene en el Playground. Así que, si reproducir el problema requiere importar un modelo 3D o un archivo de sonido, no será posible mostrarlo allí.
Obtener logs
A menudo es útil obtener los logs del explorer de Decentraland al reportar un error.
Para obtener tus logs, simplemente abre el chat y escribe /logs. Esto abrirá una nueva ventana con los logs del explorer de Decentraland. Adjunta el archivo Player.log a tu informe de issue.
Editar documentación
Si descubres problemas en el contenido del sitio web de Documentation, puedes enviar solicitudes de cambio. Simplemente desplázate hasta el final de la página y haz clic en el botón Edit this page . GitHub te guiará para crear una pull request con tus cambios. El equipo de la fundación revisará tus cambios y los publicará si consideran que son útiles.
Solicitudes de funciones y sugerencias
Si tienes sugerencias para añadir nueva funcionalidad o funciones en lugar de reportar un problema, únete al servidor de Discord de Decentraland y publica un mensaje en el canal de Creator Hub en lugar de crear un issue de GitHub.
Última actualización