La guía abierta para
Un manual comunitario sobre cómo los equipos reales entregan software.
Respuestas prácticas, no opiniones disfrazadas de buenas prácticas.
Cada guía nace de una base de código real, validada por los maintainers que la enviaron, y se revisa cuando la realidad la contradice. Explora por tema.
Git y flujos de trabajo
Trunk-based, release branches, GitFlow - cuándo cada una vale la pena y las señales de que se te quedó pequeña.
Pull requests y revisión
Plantillas que sí se revisan, límites de tamaño que se respetan y cómo dejar un comentario que no ponga a nadie a la defensiva.
Pruebas
Contract tests, higiene de snapshots, matar CI inestable - patrones que aguantan con 50 ingenieros y con 50.000.
Releases y versionado
Semver en la práctica, changelogs que tus usuarios sí leen y simulacros de rollback que no necesitan un héroe.
Contribuir al código abierto
Onboarding de nuevos contribuidores, RFCs que se entregan, gobernanza que escala sin ahogar el ritmo.
Buenas prácticas
Post-mortems, rediseños y las historias de "deberíamos haber hecho esto 6 meses antes" que vale la pena leer.
Guías reales, se leen como si emparejaras con alguien sénior.
Construido como las bases de código que documenta.
Cada guía es un PR.
Sin guardianes. El mismo flujo que documentamos es el que usamos para escribir la documentación.
Sin agenda de framework.
Si un patrón solo funciona en un stack, lo decimos. La mayoría aquí son más viejos que tu build tool.
Consejos con caducidad.
Cada guía está fechada, versionada y se revisa. Retiramos a propósito los patrones que no envejecieron bien.
El manual mejora cada vez que abres un PR.
¿Encontraste un patrón que funcionó? ¿No estás de acuerdo con una guía? Abre un pull request, cuenta tu historia o solo añade una frase - así como trabajamos es como crece la documentación.