#390 · Herramienta para desarrolladores

Issue Template Generator

Construye una plantilla de issue orientada a reportes reproducibles. Incluye descripción, pasos, comportamiento esperado y real, entorno, evidencias y checklist. Puedes cambiar el tipo entre bug, solicitud de función y tarea, y añadir instrucciones propias del repositorio para que el resultado refleje mejor el flujo de soporte o mantenimiento.

Datos de entrada

Instrucciones adicionales
Espacio publicitario

Cómo usar esta herramienta para desarrolladores

  1. Selecciona el tipo de issue.
  2. Escribe el nombre del proyecto y decide si incluir logs.
  3. Añade reglas propias en el área principal si hacen falta.
  4. Genera el Markdown y guárdalo en el repositorio.

Qué hace esta herramienta para desarrolladores

Ajusta la estructura según el objetivo: un bug necesita reproducción y entorno; una feature necesita problema y propuesta; una tarea necesita criterios de aceptación y riesgos.

El tipo seleccionado controla las secciones centrales. El checklist de duplicados, privacidad y contexto se mantiene como base común.

No pidas a usuarios que publiquen tokens, credenciales, datos personales ni logs sin revisar.

Ejemplo

Al elegir “Bug report” se incluyen pasos de reproducción, comportamiento esperado/actual y entorno; una feature cambia esas secciones por problema, propuesta y alternativas.

Casos de uso

  • Crear una plantilla simple para GitHub Issues.
  • Separar reportes de bug de propuestas de función.
  • Recordar la eliminación de datos sensibles.
  • Estandarizar criterios de aceptación para tareas técnicas.

Consejos para obtener resultados fiables

  • Pide solo información que el mantenedor vaya a utilizar.
  • Incluye versiones y entorno para bugs dependientes de plataforma.
  • Evita formularios que incentiven pegar secretos.
  • Mantén criterios de aceptación verificables en tareas técnicas.

Detalles del procesamiento

La herramienta genera Markdown genérico. GitHub Issue Forms usa YAML y requiere otra estructura; esta salida está pensada para plantillas Markdown tradicionales.

No crea labels, assignees ni configuración YAML de Issue Forms y no publica el archivo en GitHub automáticamente.

Preguntas frecuentes

¿Qué diferencia hay entre una plantilla Markdown de issue y GitHub Issue Forms?

La plantilla Markdown rellena texto editable; Issue Forms usa YAML para campos estructurados y validaciones.

¿Qué campos son importantes en una plantilla de bug report?

Pasos para reproducir, comportamiento esperado y actual, versión, entorno y evidencia no sensible suelen ser los más útiles.

¿Puedo generar una plantilla distinta para feature requests?

Sí. Selecciona Feature request y la estructura cambia a problema, propuesta y alternativas consideradas.

¿Cómo evito que los usuarios peguen secretos en los logs?

Incluye una advertencia visible y un checklist; aun así, los mantenedores deben revisar y retirar datos sensibles si aparecen.

¿Dónde puedo guardar una plantilla Markdown de issue en GitHub?

GitHub admite plantillas en .github/ISSUE_TEMPLATE/ y otras ubicaciones compatibles según la configuración del repositorio.

Resumen de salida

ElementoDetalle
Tiposbug / feature / tarea
FormatoMarkdown
Privacidadrecordatorio de datos sensibles
Destino sugerido.github/ISSUE_TEMPLATE/

Explorar Git y repositorios

Consulta más utilidades para revisar commits, repositorios, historial y archivos de configuración de Git.

Ver categoría Git y repositorios