Busca en todas las páginas de la documentación
Las guías de contribución definen cómo se integran los cambios en los repositorios de servicios de Python y esta base de conocimiento de SME: nomenclatura de ramas, expectativas de PR, reglas de revisión y CODEOWNERS, para que el mantenimiento escale más allá de un solo autor.
Tarjeta de receta de referencia rápida, lista para copiar y pegar.
## Plantilla de pull request
### Intención
### Riesgo (migración/seguridad/rendimiento)
### Evidencia de prueba (`uv run pytest path`)
### Plan de reversión
### Enlaces (RFC, ADR, ticket)# CODEOWNERS
/src/billing/ @billing-team
/docs/runbooks/ @sre-oncall
/alembic/ @billing-team @dba-reviewCuándo usar esto:
# Flujo de trabajo del contribuyente (interno)
git checkout -b feat/ENG-550-billing-retry
uv sync
uv run pytest tests/billing -q
uv run ruff check .
git commit -m "feat(billing): backoff exponencial en errores transitorios de DB"
git push -u origin feat/ENG-550-billing-retry
# Abrir PR; completar plantilla; solicitar revisión de CODEOWNERS## Contribución al cookbook de SME (site/python/)
- Un artículo por PR cuando sea posible
- Frontmatter: etiquetas únicas, slug de sección correcto
- Ejecutar `npx tsx scripts/lint-docs.ts`
- Sin guion largo; pie de página al final
- Enlaces relativos solo a páginas existentesLo que esto demuestra:
feat/, fix/, chore/ + ID de ticket.| Tipo | Requisito adicional |
|---|---|
| Característica | Enlace a especificación si es M/L |
| Migración | Revisión de expansión-contracción |
| Dependencia | pip-audit limpio |
| Solo documentación | lint-docs en verde |
# Extracto de .github/workflows/ci.yml
- run: uv sync --frozen
- run: uv run pytest
- run: uv run ruff check .feat/fix en servicios.| Alternativa | Usar Cuándo | No Usar Cuándo |
|---|---|---|
| Commit en pareja basado en trunk | Equipo pequeño de seniors | Regulación de separación de funciones |
| Fork incluso para internos | Estilo de código abierto | Cultura de confianza en monorepo privado |
| Ramas de lanzamiento | Versiones de soporte a largo plazo | Despliegue continuo de main |
| Sin CODEOWNERS | Mantenedor único | Monorepo multi-equipo |
CODEOWNER del servicio + grupo de revisores de DBA según la política.
Auto-merge de parches si CI está en verde; menores revisados semanalmente.
Crear rama desde etiqueta; PR con DoD reducido; backport a main.
Seguir las formas de artículo/lista de sme-content; manifestar categoría python.
Opcional; requerido si la política de la organización lo exige.
Recomendado para trabajo grande; pequeñas correcciones OK solo con PR.
Apache-2.0 o MIT según legal; se requiere archivo LICENSE.
Se anima el crédito de emparejamiento; ambos revisaron el PR.
Cerrar después de 30 días de inactividad; el autor reabre cuando esté listo.
Canal privado según SECURITY.md; sin incidencia pública para vulnerabilidades.
Versiones de Stack: Esta página fue escrita 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