Prácticas recomendadas para el equipo
Un resumen condensado de las 25 prácticas de equipo más importantes que mantienen a un equipo de ingeniería de Python rápido, alineado y amable, extraído de cada página de esta sección.
//
Busca en todas las páginas de la documentación
Un resumen condensado de las 25 prácticas de equipo más importantes que mantienen a un equipo de ingeniería de Python rápido, alineado y amable, extraído de cada página de esta sección.
El tiempo hasta el primer PR es la métrica: Objetivo de PR pequeño fusionado para el quinto día - mide la incorporación y la salud de las herramientas (Lista de verificación de incorporación de desarrolladores).
Un documento de incorporación canónico: Enlazado desde README con propietario nombrado y fecha de última revisión.
Compañero para la primera semana: Compañero nombrado, registro diario de 15 minutos - no "pregúntale al equipo".
La configuración del entorno está en scripts: uv sync, pytest, /health documentado en Lista de verificación de configuración del entorno.
Los comandos de CI se ejecutan localmente: El mismo ruff/pytest/mypy que GitHub Actions antes de enviar.
.env.example siempre actualizado: Cada nuevo campo de configuración actualiza el ejemplo sin secretos.
CODEOWNERS en rutas sensibles: Migraciones, autenticación, pagos solicitan automáticamente a expertos.
ADR para decisiones no obvias: Estrategia de framework, esquema y flags registrada en docs/adr/.
Rastrear una solicitud en la primera semana: Más rápido que leer el árbol completo (Orientación de la base de código).
Convenciones en la configuración de ruff: Los debates de estilo terminan en pyproject.toml, no en comentarios de revisión (Guía de convenciones y estilo).
ID de ticket en cada commit: Los cherry-picks y la automatización del registro de cambios dependen de ello.
Plantilla de descripción de PR: Nota de migración, plan de pruebas, reversión - campos requeridos.
Revisar pruebas antes de la implementación: Los revisores validan el cambio de comportamiento a través de aserciones.
Comentarios de revisión específicos y amables: Preguntas y sugerencias, no "simplemente arréglalo" sin contexto (Guía de revisión de código).
Aprobar cuando se cumple el estándar: No bloquear por preferencia cuando CI está en verde y P0/P1 satisfechos.
PR pequeños por defecto: Dividir cuando la diferencia es > ~400 líneas o preocupaciones mixtas.
Los traslados internos reciben incorporación: Senior a nuevo subsistema todavía necesita acceso y recorrido de arquitectura.
Se celebran los PR de documentación de los nuevos empleados: El primer PR que corrige un error tipográfico en la incorporación es una señal de éxito.
Actualizaciones de documentación post-incidente: Cada sev2+ actualiza el runbook o un elemento de la lista de verificación.
Retrospectivas sin culpa: Enfocarse en los sistemas - actualizar listas de verificación, no individuos.
Objetivos compartidos de shell/Makefile: make test, make lint documentados para todos los repos.
Sin heroicidades en el despliegue: Seguir la lista de verificación; informar sobre la falta de proceso si se necesita un atajo.
Rotar la guardia con un observador: Los nuevos empleados observan antes de estar de guardia solos.
Higiene trimestral de dependencias: Elementos de sprint programados para CVE y actualizaciones menores de Python.
Normas del equipo por escrito: Las reglas no escritas se convierten en control de acceso - publicar y revisar abiertamente.
Añadir horas explícitas de solapamiento, grabaciones de recorridos de arquitectura y registros de decisiones escritos en hilos de Slack enlazados a ADRs.
Un ticket, una preocupación, revisable en 30 minutos - no solo una línea si la prueba necesita contexto.
Preferir un compañero para la seguridad psicológica; el gerente se une en la revisión de la segunda semana.
El mismo estándar de revisión y seguridad; aclarar la transferencia de propiedad al final del contrato.
Versiones de la pila: Esta página se escribió para Python 3.14.0 (estable 3.14, mantenimiento 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+, y uv 0.6+.
Revisado por Chris St. John·Última actualización: 16 jul 2026