Guía de estilo¶
Normas editoriales, de estructura y de estilo para mantener la coherencia del sitio. La referencia para cualquier persona —o IA— que contribuya.
-
Plantillas para cada tipo de página: fichas, manifiestos, compromisos, roles, runbooks, proyectos, sistemas.
¿Hay plantilla para lo que necesito?
Sí: fichas de servicio, manifiestos, compromisos, roles, runbooks, sistemas y más. Cada una con su estructura obligatoria. -
Principios de la documentación: honestidad, consistencia, autosuficiencia, comprensibilidad.
¿Qué principios guían la documentación?
Honestidad: cada página refleja el estado real. Comprensibilidad: cualquier persona debe entenderlo. Tiempos verbales: según el estado del servicio. -
Reglas de enlaces, uso del logo, voz y tono, diagramas Mermaid, proceso de creación.
¿Cómo se escriben los enlaces y diagramas?
Los enlaces externos solo desde fichas. El logo inline es obligatorio en cada aparición de SmallCountry. Los diagramas Mermaid deben seguir el estándar de colores y formas.