> For the complete documentation index, see [llms.txt](https://urd.gitbook.io/compass/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://urd.gitbook.io/compass/home/espanol/aprendizaje-y-adaptacion/aprender-de-la-experiencia-y-compartir-conocimientos/documentacion-y-difusion-formatos-divulgacion-y-salvaguardias.md).

# Documentación y difusión: formatos, divulgación y salvaguardias

**Una lección que no se comparte no tiene efecto.**

Una vez que una experiencia ha sido capturada (mediante una sesión de debriefing o un proceso estructurado de aprendizaje de lecciones), el trabajo no ha terminado. Todavía debe convertirse en algo que otra persona pueda retomar y usar. Esta página explica cómo elegir un formato, escribirlo bien, compartirlo de forma responsable y evitar causar daño en el proceso.

***

### <mark style="color:naranja;">**Elegir un formato**</mark>

Ajusta el formato al esfuerzo ya invertido y al público identificado durante el encuadre, yendo de lo más sencillo a lo más elaborado:

<table><thead><tr><th width="194">Formato</th><th width="140">Extensión</th><th>Ideal para</th></tr></thead><tbody><tr><td>Hoja de buenas prácticas</td><td>1–2 páginas</td><td>Una práctica concreta que vale la pena repetir, destinada a equipos internos</td></tr><tr><td>Informe posterior a la acción</td><td>1–2 páginas</td><td>Una actividad recién concluida que se repetiría</td></tr><tr><td>Resumen de lecciones aprendidas</td><td>2–4 páginas</td><td>Un relato más completo de una experiencia, con contexto y matices</td></tr><tr><td>Estudio de caso</td><td>Varias páginas</td><td>Un recurso independiente que puede alimentar la capacitación o la incidencia</td></tr><tr><td>Nota de orientación</td><td>Varía</td><td>Recomendaciones destinadas a orientar el diseño de proyectos futuros</td></tr></tbody></table>

No hay obligación de avanzar en esta lista. Una hoja de una página, bien redactada y que de verdad se lea, vale más que un estudio de caso inacabado.

***

### <mark style="color:naranja;">**Principios para escribirlo bien**</mark>

* **Empieza por lo que importa:** Un lector que lo hojee durante 30 segundos debería irse igualmente con la idea esencial. Consolida los puntos de acción al principio o al final del documento para facilitar la consulta. Eso sería lo más importante para los usuarios potenciales.
* **Sé honesto sobre lo que no funcionó:** Un documento que solo muestra el éxito no logra extraer todo el aprendizaje de la experiencia. El valor suele concentrarse en lo que salió mal y por qué.
* **Atribuye con cuidado:** Reconoce a las personas y decisiones implicadas sin exponer innecesariamente a individuos. No siempre hace falta nombrar a las personas; lo que importa es lo que tienen que decir. Sin embargo, a veces ayuda aclarar su papel para interpretar correctamente su testimonio.
* **Escribe para la acción:** Cada lección debería traducirse en algo concreto que un lector realmente pudiera hacer de otra manera.

***

### <mark style="color:naranja;">**Compartirlo**</mark>

**Internamente**

* Integra las hojas de lecciones en la inducción de nuevos miembros del equipo.
* Inclúyelas en las sesiones informativas de inicio de proyecto, como se expone en el [Diseño](/compass/home/espanol/implementando/diseno.md) o en las revisiones de proyecto.
* Guárdalas en un único repositorio fácil de encontrar, en lugar de dispersarlas entre las carpetas individuales de los proyectos.
* Asegúrate de que las recomendaciones o acciones se registren en la herramienta de gestión de proyectos, en el seguimiento de recomendaciones (o en cualquier herramienta pertinente que tengas), para que el gestor del proyecto pueda&#x20;

**Externamente**

* Compártelo con los socios operativos y los mecanismos de coordinación, especialmente con quienes contribuyeron al documento.
* Contribuye al aprendizaje de todo el sector cuando sea pertinente. En consonancia con el Compromiso 6 (coordinación y complementariedad) y el Compromiso 9 (usar los recursos de manera responsable, ayudando a otros a evitar repetir errores costosos).

***

### <mark style="color:naranja;">**Salvaguardas: proteger a las personas, no solo los datos**</mark>

Cuando una lección se basa en testimonios de comunidades o del personal, aquí se aplican los mismos principios que se aplican al tratamiento de datos en otras partes de Compas: **consentimiento informado**, **anonimización** cuando sea necesario, y **especial cuidado** cuando la experiencia toca un tema sensible (preocupaciones de protección, salvaguarda, conflicto interno).

Documentar una lección nunca merece hacerse «a toda costa». Si compartirla corre el riesgo de exponer a alguien, lo correcto es documentarla solo para uso interno, o no documentarla en absoluto.

***

### <mark style="color:naranja;">**Puntos clave**</mark>

* Ajusta el formato al público: no recurras por defecto al más elaborado disponible.
* Los relatos honestos del fracaso tienen más valor transferible que las historias de éxito pulidas.
* Una lección solo tiene impacto cuando llega a alguien que puede actuar sobre ella.
* Compartir internamente no es un trabajo preliminar opcional; a menudo es donde se encuentran las mayores ganancias.
* Nunca dejes que la ambición de documentar prevalezca sobre la responsabilidad de proteger a las personas de las que trata la lección.