Estándares
Un estándar es una norma o un criterio que aplica a todos los equipos: cómo revisamos código, cómo escribimos tests, qué convenciones sigue nuestro GraphQL.
Estándares y guías
Un estándar dice qué es correcto. Una guía dice cómo se hace. Cuando dudes, pregúntate si tu página se puede incumplir: un criterio de code review se incumple, un how-to de configuración de CDN no.
Cómo se estructura
El tema manda en el primer nivel; la disciplina aparece debajo y solo cuando el contenido diverge de verdad. Un estándar de GraphQL que aplica a backend y frontend vive en /standards/api/graphql/ una sola vez, y se divide en backend y frontend el día que dejen de coincidir. La URL del tema no cambia.
Secciones
- Modelo de branching — el Git flow de los repositorios
- Branches y commits — nombres de branches y mensajes de commit
- Diseño de inputs para queries y mutations — el patrón de input object único en GraphQL
- Estándares de documentación técnica — cómo documentamos cambios técnicos
- Definition of Done — los requisitos de toda entrega
- Criterios de code review
Quién aprueba
Un estándar obliga a todos los equipos, así que lo aprueban todos los equipos afectados a través del MR. Los pasos están en cómo contribuir al portal.