heydeer
Buenas prácticas

Implantación en tu equipo

Introduce HeyDeer por etapas y deja que controle las fusiones solo cuando tu equipo confíe en sus resultados.

Antes de empezar

Un administrador del espacio de trabajo cambia la configuración en cada etapa; cualquiera con acceso de escritura puede solicitar revisiones. Consulta Miembros del espacio de trabajo.

Todos los planes incluyen créditos mensuales. Un espacio de trabajo nuevo empieza con 1000 créditos durante su primer mes en el plan gratuito. En cualquier plan, incluido Free, puedes añadir créditos con una tarifa base de $10 por cada 1.000 créditos.

Los correos sobre créditos y pagos se envían a la dirección de Configuración del espacio de trabajo → Notificaciones. Usa una dirección que consulte tu equipo, como una dirección compartida; consulta Correo de notificaciones.

Etapas

  1. Opcional: prueba HeyDeer antes de que lo vea tu equipo. En Configuración del espacio de trabajo → Reglas de revisión → Publicar resultados, desactiva Publicar comprobación de GitHub y Publicar comentarios de revisión en el PR. Solicita revisiones con Iniciar revisión, lee los resultados en la página Historial de revisiones y vuelve a activar ambas opciones antes de la siguiente etapa.
  2. Pruébalo en unos pocos pull requests. Cuando HeyDeer muestre Personaliza tus revisiones después de la configuración, desactiva Revisar pull requests automáticamente y selecciona Continuar para que solo revise cuando se solicite. Después, comenta @heydeer review en varios pull requests abiertos de distintos tipos y compara los hallazgos con los de tus revisores.
  3. Cubre las carencias que viste. Añade solo lo que esas revisiones demostraron que necesitas: convenciones de código en AGENTS.md, requisitos en comprobaciones del repositorio y prioridades en las instrucciones de revisión. Consulta Qué lee HeyDeer.
  4. Activa las revisiones automáticas en uno o dos repositorios: en Repositorios, selecciónalos y después elige Cambiar frecuencia. Cuando sus revisiones sean las esperadas, define la frecuencia del espacio de trabajo en Configuración del espacio de trabajo → Reglas de revisión → Cuándo revisar.
  5. Pasa a la configuración adecuada para tu equipo. Exige la comprobación HeyDeer Review y decide si usar la aprobación automática. Consulta Equipos sin revisión de código o Equipos con revisores humanos.
  6. Configura el control de gastos. En un plan de pago, activa la recarga automática y establece un límite de uso. Consulta Recarga automática y límites de uso.
  7. Explica al equipo cómo trabajar con HeyDeer. Comparte los comandos en comentarios de PR y cómo descartar un hallazgo.

Si un pull request no se revisa cuando esperas, consulta Solución de problemas.

Cuándo pasar a la siguiente etapa

Pasa a la siguiente etapa cuando las revisiones recientes muestren todo esto:

  • Tu equipo atiende la mayoría de los hallazgos.
  • Los hallazgos descartados no siguen un patrón que puedas corregir con instrucciones de revisión o una comprobación del repositorio. Si lo siguen, consulta Reducir el ruido.
  • Las revisiones terminan sin notas de la revisión, como una comprobación del repositorio que no se ejecutó.

Al cabo de unas semanas, vuelve a leer las revisiones recientes. Mueve cada pauta a donde le corresponde y elimina las instrucciones y comprobaciones que nunca cambian una revisión.