Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →
Informar sobre problemas
Esta página explica cómo abrir incidencias, incluyendo las políticas y procedimientos del proyecto Jellyfin para gestionarlas.
Las incidencias deben exclusivamente detallar reportes de errores de software.
Todas las demás discusiones, incluyendo solución inicial de problemas, deben dirigirse a nuestros canales de ayuda.
Solicitar funcionalidades
Ten en cuenta que las solicitudes de funcionalidades y mejoras deben dirigirse a nuestra instancia de Fider para seguimiento, votación y reporte. Por favor, limita todas las solicitudes de funciones a esta página y no a incidencias de GitHub.
Buscar y votar
Antes de abrir una incidencia, por favor busca en las incidencias existentes para ver si ya se reportó un problema o solicitud similar. Las incidencias duplicadas saturan el repositorio y deben evitarse.
Si encuentras una incidencia que coincide, o coincide de cerca, con tu problema, usa la reacción 👍 para confirmar que también te afecta o que apoyas la solicitud. Si lo deseas, añade también un comentario describiendo tu versión del problema o caso de uso.
Si la incidencia existente está cerrada, léela para ver si las soluciones alternativas aplican a tu caso. Si no, deja un comentario y la incidencia se reabrirá. Ten en cuenta que, dado que los PR se fusionan primero en dev pero las versiones se construyen desde master, la corrección de una incidencia no estará disponible inmediatamente en las fuentes oficiales, pero se incluirá en la próxima versión.
Abrir una incidencia
¡Cuando estés listo para abrir una incidencia, por favor visita esta página!
Reportar errores
Al escribir un reporte de error, asegúrate de incluir tantos detalles relevantes como sea posible; esto es crucial para ayudar en la solución de problemas y la investigación. Algunos elementos útiles incluyen:
-
Cómo instalaste Jellyfin (actualización o instalación nueva)
-
Plataforma y sistema operativo que usas (Debian, Arch, Docker, etc.)
-
Qué estabas haciendo cuando apareció el error
-
Cualquier registro relevante
-
Configuraciones no estándar que utilices
Los errores deben etiquetarse con [bug] al inicio de su título. Posteriormente, el equipo de Jellyfin eliminará esta etiqueta al asignar otras. Para ayudar en la clasificación, si conoces qué otras etiquetas deberían aplicarse a tu incidencia, añádelas después de [bug].
Los errores deben ser reproducibles. Es decir, debes haber determinado mediante solución de problemas cómo replicar el problema. Aunque no se deben ignorar los errores únicos, si son difíciles o imposibles de reproducir, será muy complejo solucionarlos. Por favor, intenta reproducir el error antes de reportar la incidencia e incluye el caso de prueba más pequeño posible que demuestre el comportamiento.
Si necesitas ayuda para resolver problemas o abrir una incidencia, por favor contacta a la comunidad ¡e intentaremos ayudarte!
Etiquetas de incidencias
Jellyfin utiliza varias etiquetas para ayudar en la clasificación y gestión de incidencias. Los usuarios no pueden asignarlas debido a los permisos de GitHub, pero un miembro del equipo las añadirá durante la clasificación.
Categorías
Estas etiquetas son categorías amplias que indican qué parte del código se ve afectada.
-
backend: Problema relacionado principalmente con el código del servidor backend. -
build: Problema relacionado principalmente con el proceso de compilación.
Criticidad
Estas etiquetas ayudan a determinar qué tan crítica es una incidencia.
-
regression: Un problema que requiere atención inmediata debido a una regresión en la última versión. -
bug: Un error en el código que afecta al uso normal.
Gestión
Estas etiquetas ayudan en la gestión del proyecto y su dirección.
-
good first issue: Algo muy sencillo de implementar, ideal para empezar a contribuir. -
help wanted: Una incidencia sin experto claro dentro del proyecto que podría beneficiarse de ayuda externa. -
roadmap: Una meta-incidencia relacionada con el plan de futuro del proyecto. -
investigation: Una incidencia de tipo investigación sobre la base de código.
Solicitudes de extracción (Pull Requests)
Estas etiquetas aplican exclusivamente a solicitudes de extracción con fines administrativos.
requires testing: Una PR que aún no ha sido probada en entorno real. Cualquier PR importante que afecte al backend debe probarse antes de fusionarse para evitar regresiones.