¿Hay alguien que se lee la documentación?

Estos días leía un libro de arquitectura software en el que te aconsejaba: «No escribas documentación de más de 5 páginas. No se la van a leer».

Y ahora qué hago yo con los documentos de 40-60 páginas que escribí hace solo unas semanas!?

Me temo que tiene mucha razón. Veo los accesos a esos documentos, y apenas hay visitas. Solo unas pocas personas accedieron a ellos, y estoy seguro de que la mayoría solo le echaron un vistazo al índice y pulsaron Control-F para buscar algún término que les llevara directamente al grano.

Si quiero que estos documentos sean útiles, creo que mejor paso esos docs Word a páginas Confluence con solo un par de páginas por sección y unos pocos párrafos explicando lo impresicindible. Como máximo!