Guía de lectura
El Estándar describe una serie de criterios. Todos los criterios tienen secciones consistentes que clarifican cómo crear un gran código público. Debajo se encuentra una breve explicación de cada una de estas secciones y cómo son usadas dentro de los criterios del Estándar.
Requisitos
Esta sección lista lo que necesita ser desarrollado para cumplir con el estándar.
Para limitar la ambigüedad, las palabras clave “DEBE”, “NO DEBE”, “REQUIERE”, “PODRÍA”, “NO PODRÍA”, “DEBERÍA”, “NO DEBERÍA”, “RECOMIENDA”, “PUEDE”, y “OPCIONAL” de este documento deben ser interpretadas de acuerdo con el documento IETF RFC 2119.
Por qué es importante
Esta sección explica por qué es importante seguir los requisitos para personas usuarias y contribuyentes de esta codebase.
Qué no hace
Esta sección gestiona expectativas a través de la explicación de requisitos que el criterio no cumplirá.
Esto ayuda a:
- Aplicar de manera correcta el Estándar.
- Asegurarse de que surjan imprevistos.
Cómo probar o hacer tests
Esta sección ofrece acciones que puedes llevar a cabo para comprobar si una contribución cumple con el Estándar. Resulta muy importante si quieres hacer operativo el Estándar.
Hemos tratado de redactarlo de manera que alguien que no esté muy familiarizado con el tema pueda hacer una comprobación básica de su cumplimiento.
Responsables políticos o legisladores: qué necesitan hacer
Esta sección trata de dirigirse específicamente a responsables políticos ofreciéndoles acciones concretas que pueden llevar a cabo en su función.
Las personas responsables políticas establecen las prioridades y objetivos de los proyectos y pueden tener menos experiencia tecnológica.
Profesionales de la dirección de equipos: qué necesitan hacer
Esta sección trata de dirigirse específicamente a personas directivas, ofreciéndoles acciones concretas que pueden llevar a cabo en su función.
La dirección es responsable de la entrega del proyecto a tiempo, de la gestión de las partes interesadas y de la prestación continua del servicio. Para ello depende totalmente tanto de responsables políticos como de profesionales del desarrollo y diseño. Debe crear la cultura adecuada, alinear los recursos correctos y proporcionar las estructuras adecuadas para prestar grandes servicios.
Profesionales del desarrollo de software y diseño: qué necesitan hacer
Esta sección trata de dirigirse específicamente a profesionales del desarrollo y diseño ofreciéndoles acciones concretas que pueden realizar en su función.
Las personas profesionales del desarrollo suelen estar más alineadas técnicamente y tienen más impacto en la prestación de servicios que los grupos anteriores.