Reportar un bug
Cómo puedes reportar un bug para que sea revisado y corregido
Si encuentras errores o problemas con el SDK de Decentraland y el Scene Editor en Creator Hub, por favor repórtalos en nuestro repositorio de GitHub aquí.
Antes de reportar un error
Antes de enviar un informe de error, por favor asegúrate de lo siguiente:
Asegúrate de que estás usando la versión más reciente del SDK, en caso de que el problema ya haya sido corregido en lanzamientos más nuevos.
Revisa la documentación de la función que intentas usar, para confirmar que debería comportarse como esperas y que esto no sea solo un malentendido.
Descarta que el problema pueda ser causado por cómo está construida tu escena. Ver Depurar en Preview y Depurar 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, por favor añade 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 Comenzar junto a Reporte de Bug.
Completa todos los campos en la plantilla. La plantilla proporciona instrucciones para cada sección. Cuantos más detalles puedas proporcionar, más rápido nuestros desarrolladores podrán identificar y resolver el problema.
Haz clic en Enviar nuevo issue.
Los desarrolladores pueden hacer preguntas de seguimiento en tu ticket si necesitan aclaraciones o información adicional. Recibirás notificaciones por correo electrónico sobre actualizaciones de tu informe de error.
📔 Nota: Para cualquier problema no relacionado con el SDK, por favor contacta al equipo de soporte. Para comunicarte, por favor visita esta página intercom.decentraland.org o envíanos un correo electrónico a [email protected]. También puedes encontrarnos en Discord. El equipo está disponible para ayudar de lunes a domingo, de 12:00 a 21:00 UTC y hará lo posible por responder lo antes posible. Puedes esperar una respuesta dentro de 60 min en Discord durante el horario anterior y dentro de 24 h por correo electrónico.
También puedes contactar al equipo de soporte del DAO en el DAO Discord.
Consejos adicionales para informes de errores:
Crea un issue separado para cada error. Si encuentras múltiples problemas, asegúrate de crear un nuevo issue para cada uno.
Evita explicaciones extensas. Incluye solo la salida relevante de la línea de comandos o de la consola, o el código de la escena 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 carga y el enlace.
Uso del Decentraland Playground
Proporcionar fragmentos de código que demuestren el problema es extremadamente útil. La reproducibilidad es crucial. Si no se puede reproducir un error, 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 escena en el panel derecho.
Haz clic en el Compartir botón y pega el enlace en tu informe de issue.
Usar el playground simplifica la reproducción del issue y asegura que cualquiera que abra el enlace pueda ver la misma salida, independientemente de 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 localizar la causa del problema.
Mantén tu ejemplo lo más conciso posible, al mismo tiempo que reproduzca el problema. Un ejemplo más simple ayuda a eliminar la ambigüedad sobre la fuente del problema.
📔 Nota: No es posible importar assets a tu escena en el Playground. Por lo tanto, si reproducir el problema requiere importar un modelo 3D o un archivo de sonido, no será posible mostrarlo allí.
Obtener registros
A menudo es útil obtener los registros del Explorer de Decentraland al reportar un error.
Para obtener tus registros, simplemente abre el chat y escribe /logs. Esto abrirá una nueva ventana con los registros del Explorer de Decentraland. Adjunta el Player.log archivo a tu informe de issue.
Editar la documentación
Si descubres problemas en el contenido del sitio de la Documentación, puedes enviar solicitudes de cambio. Simplemente desplázate hasta la parte inferior de la página y haz clic en el Editar esta página botón. GitHub te guiará para crear un pull request con tus cambios. El equipo de la foundation revisará tus cambios y los publicará si se consideran útiles.
Solicitudes de funciones y sugerencias
Si tienes sugerencias para agregar nueva funcionalidad o características en lugar de reportar un problema, por favor únete al Decentraland Discord Server y publica un mensaje en el Creator Hub Channel en lugar de crear un Issue en GitHub.
Última actualización