a que se refiere cuando dice "documentar"?

En un proyecto con modelo predictivo "Waterfall", documentar hace referencia a escribir en documentos extensos la información detallada de lo que el cliente quiere como resultado (Requisitos y sus características), esto toma tiempo, luego se debe entregar los documentos al cliente para que este los firme aceptando lo que se va a hacer y solo entonces empiezas a ejecutar las actividades. Por lo anterior, puede tomar mucho tiempo entre documentar y generar un primer producto para entregar al cliente.

En un ejemplo muy simple, cuando vas a un restaurante y el mesero anota tu orden, está documentando tus requisitos (Lo que se tiene que cumplir para que quedes satisfecho), luego te lee lo que escribió y confirma contigo la orden, si estás de acuerdo, va a la cocina para que cocinen la comida que pediste y por último te la entrega y confirma que quedes satisfecho con la comida que te llevó. En este ejemplo la acción de documentar no toma tiempo, pero en un proyecto puede tomar varios días escribir detalladamente lo que quiere el cliente en documentos de muchas hojas que luego hay que entregarle al cliente para que este firme en señal de aceptación.

En el mismo ejemplo, ¿Qué pasa si a mitad de la preparación de tu comida quieres agregarle algo más a tu plato?, debes llamar al mesero y pedirle la adición, el toma nota (Documenta) va a la cocina y es muy posible que lo que pediste lo agreguen al plato a tiempo. Sin embargo, en un proyecto "waterfall", si el cliente pide un cambio, pueden pasar días antes de que lo escriban, el cliente lo lea y luego lo empiecen a realizar.

El método Waterfall se veía mucho antes. El desarrollador relevaba requisitos (con el dueño o gerente o supervisor), luego de 6 meses presentaba le desarrollo. Cuando se lo mostraban al usuario final no se adaptaba, o no era lo que necesitaba. Es muy importante que en el revelamiento estén presentes los usuarios finales, son los que ejecutan la tarea día a día y los que lo usaran.

Muchas gracias a quienes se tomaron unos minutos para responderme, fue muy clarificante!!

La documentación como se hace en Waterfall es llevar un paso a paso y hacer como una guía y dale una solución luego de mucho tiempo lo que se conoce como burocracia , aquí lo mas importante es que tu desarrollo este funcionando. va a ser más importante que puedas responder rápido a los cambios y no realmente seguir un plan. es decir Lograr que tu software funcione. Todo se encamina en ser ágil practico dar soluciones a tu cliente , buscar que lo que te pidio el proyecto sea sencillo robusto y efectivo siendo muy eficaz pero al momento que se presente algún inconveniente es dar una solución más rápida y simple

Gracias José , un abrazo!