Gobernanza para un proyecto pequeño: derechos de decisión por escrito antes de necesitarlos

Qué es

La gobernanza es el conjunto de reglas que establecen quién puede decidir qué y cómo se reconoce que una decisión ya está tomada. Tres modelos cubren la mayoría de los proyectos pequeños. Un único mantenedor decide todo y lo dice abiertamente. Un grupo reducido decide por consenso perezoso (lazy consensus), que el glosario de Apache define como una política que da por supuesto el consentimiento general si no se publica ninguna respuesta dentro de un plazo definido, y que reserva la votación explícita para las cuestiones controvertidas. Un consejo ostenta la autoridad final: la PEP 13 dota a Python de un consejo director de cinco personas con amplia autoridad, que según el documento procura ejercer lo menos posible, prefiriendo el consenso y los procesos habituales a las resoluciones, votando por mayoría estricta de los miembros que no se abstienen y deliberando en público siempre que sea posible.

Por qué importa

Sin reglas escritas, las disputas las zanja quien más grita o el silencio, los colaboradores no pueden saber si una propuesta está aprobada o simplemente nadie se ha opuesto, y un traspaso no tiene en qué apoyarse. Las reglas importan menos en los días normales y más el día en que dos mantenedores discrepan sobre la API pública.

Cómo aplicarlo

• Escribe un archivo GOVERNANCE de una página: mantenedores por nombre y área; quién puede fusionar qué; la regla de decisión por defecto (consenso perezoso con un plazo indicado para los cambios rutinarios, y acuerdo explícito de todos los mantenedores para la API pública, la licencia, el alcance y la incorporación de un mantenedor).
• Define un criterio de desempate para el caso de dos mantenedores: un responsable de área para cada módulo, o una decisión final rotatoria, acordado ahora y no en medio de una disputa.
• Define cómo se añade un mantenedor (propuesta, plazo, acuerdo) y cómo pasa a estar inactivo o se le retira, incluido el caso de un mantenedor al que no se puede localizar.
• Registra las decisiones donde se tomaron: el hilo del issue o del pull request, y un registro de decisiones de arquitectura (architecture decision record) para todo lo que afecte a la forma del código.
• Mantén la deliberación en público, como la PEP 13 exige a su consejo siempre que sea posible; una decisión privada debe publicarse después con sus motivos.
• Haz que el archivo solo pueda modificarse según su propia regla y pon fecha a cada cambio.

Trampas

Copiar la estructura de un consejo para dos personas. Reglas que se escriben y nunca se aplican, de modo que el primer uso real es también la primera prueba. Tratar el silencio como consentimiento sin un plazo establecido, lo que permite que una propuesta pase porque nadie la leyó. Una gobernanza que nombra personas pero no áreas, de modo que todas las cuestiones acaban en manos del fundador.