Gobernanza y decisiones¶
La gobernanza distingue participar, revisar, mantener el repositorio y aceptar cambios
metodológicos. La administración inicial se realiza bajo Kasai Labs, en el espacio
kasailabs de Codeberg. José Adrián Ruiz-Carmona figura como autor inicial de la
documentación. Autoría, administración y responsabilidad de revisión son roles diferentes.
El mantenimiento comienza con esa administración inicial. La incorporación de otras personas se registra públicamente; esta política no presupone un consejo, una votación realizada ni un equipo de revisores ya constituido. El objetivo es distribuir responsabilidades mediante designaciones trazables y permitir aportaciones sin afiliación comercial.
Roles y alcance¶
| Rol | Responsabilidad | Autoridad |
|---|---|---|
| Persona contribuyente | Presenta texto, evidencia o comentarios y responde por su aportación. | Puede proponer y pedir revisión; una propuesta no cambia una edición aceptada. |
| Persona revisora | Contrasta claridad, fuentes, traducción, compatibilidad o una especialidad declarada. | Registra observaciones y recomendación dentro de su alcance; revisar no concede permisos de fusión. |
| Persona mantenedora | Coordina revisión, registra decisiones y prepara o integra cambios. | Actúa dentro de la delegación pública y los permisos efectivos del repositorio. |
| Responsable metodológico | Decide cambios normativos del método dentro del alcance que tiene asignado. | Acepta una edición identificada mediante decisión humana registrada. |
| Administración del repositorio | Gestiona acceso y continuidad operativa. | Configura permisos; el acceso administrativo no demuestra aprobación metodológica. |
Las designaciones vigentes se publican en MAINTAINERS.md. Una persona puede ocupar varios roles si declara sus alcances. La autoría inicial no exige que el fundador apruebe exclusivamente cada corrección editorial. Una persona mantenedora con delegación registrada puede resolver esos cambios dentro de su competencia.
Incorporar o cambiar responsabilidades¶
Una propuesta de designación se discute en una Issue o PR. Identifica la cuenta pública, el rol, las metodologías o carpetas cubiertas, las decisiones permitidas, los conflictos de interés declarados y las condiciones de revisión o retirada. La persona acepta el rol y la administración registra quién autorizó la asignación y desde qué fecha aplica.
Cambiar permisos en Codeberg ejecuta esa asignación; no sustituye su registro. La revisión de responsabilidades puede solicitarse por disponibilidad, cambio de alcance o conflicto. El mismo registro identifica la retirada o sustitución y cómo continúa el trabajo pendiente. No se publica información personal innecesaria para explicar un rol.
La incorporación progresiva de mantenedores y responsables metodológicos permite distribuir revisión y decisiones. La transición administrativa se documenta cuando ocurre; no se afirma que el control operativo ya haya pasado a una comunidad autónoma.
Decidir según el cambio¶
| Cambio | Revisión y decisión |
|---|---|
| Errata, enlace o presentación | Revisión editorial y decisión de la persona mantenedora competente. |
| Explicación, ejemplo, fuente o traducción | Revisión de significado y fuentes; registrar diferencias y límites antes de integrar. |
| Requisito, excepción o alcance normativo | Propuesta motivada, análisis de impacto y decisión del responsable metodológico; una modificación requiere nueva edición identificada. |
| Gobernanza o asignación de autoridad | Propuesta pública, objeciones y respuesta; decisión de quien tenga autoridad vigente para ese cambio, con alcance y fecha explícitos. |
Una propuesta normativa identifica la edición afectada, el requisito, alternativas, evidencia, compatibilidad y transición. Las ediciones aceptadas conservan texto, IDs y registros de integridad históricos; no se reescriben para presentar la propuesta como ya aceptada. SCAFFOLD-R-017 sigue pendiente fuera de SCAFFOLD 0.1, según su registro de aceptación.
La discusión busca argumentos contrastables y respuestas a las objeciones. El número de comentarios, reacciones o PR no sustituye una decisión competente. La política no fija un quórum ni un plazo automático de aceptación; una cuestión sin resolver queda identificada como tal, con siguiente acción y responsable cuando se haya asignado.
Registro de una decisión¶
La Issue o PR conserva un registro público enlazado con estos campos:
- Problema, propuesta y enlaces a la discusión y al PR, cuando exista.
- Fecha y hora, y cuenta pública de la persona responsable de decidir.
- Rol y alcance de autoridad usados para esa decisión.
- Resultado: aceptar, pedir cambios, rechazar o retirar, con su razón.
- Páginas, requisitos y versiones afectados; impacto y transición cuando corresponda.
- Evidencia y comprobaciones realizadas, con pendientes declarados.
- Objeciones materiales, respuesta y desacuerdos que permanecen.
La persona mantenedora enlaza ese registro desde el cambio o historial pertinente. Integrar un PR y publicar un release son efectos distintos de aceptar una edición metodológica. Los mensajes públicos y los registros no incluyen material sensible; se conserva una descripción depurada cuando el detalle necesita tratamiento reservado.
Reconsideración y continuidad¶
Para pedir reconsideración, enlaza la decisión, explica el desacuerdo y aporta nueva evidencia o un error verificable del proceso. Se solicita revisión a otra persona mantenedora o revisora con alcance adecuado cuando esté disponible. Si no existe otra persona designada, se declara esa limitación y se registra quién revisa; no se presenta como revisión independiente.
Una controversia técnica se trata mediante revisión de contenido. Los problemas de convivencia siguen la política de participación. Las decisiones sobre integración en este repositorio no limitan los usos y forks permitidos por la licencia documental.