La documentación

En cualquier proyecto, la documentación, tanto de uso de lo que estás construyendo, como de uso de las herramientas que usas para hacerlo, debe hacerse, no para entenderla los que están involucrados en el proyecto, sino para que la entienda cualquiera, que no tenga ni idea del proyecto, ni del producto. Y eso, que dicho así parece fácil, no es nada sencillo.

Todos hemos estado en un proyecto, en el que alguien elabora un documento, que sirva de guía para trabajar a los nuevos y cuando lo coge cualquiera, no sabe ni por dónde tiene que funcionar, lo que hace que pasen dos cosas, la primera es que, si no pregunta, cometa errores y la segunda, que no sea productivo y haga que alguien que sí lo es, deje de serlo, porque tiene que estar enseñándole.

Por eso, cuando hagáis los "guiaburros", perder algo de tiempo en hacerlo para alguien que no sepa de nada, porque ese tiempo que crees que estás perdiendo, lo ganarás con creces en el futuro.