Por qué es importante escribir documentos de diseños de software

Sugerencias de Chris Fox

Chris Fox nos dice que trabajar directamente con los clientes, es un desafío más grande de lo que aparenta ser. Es muy importante tener comunicación con el cliente y en cada etapa del trabajo estar seguro que la idea sea congruente con el objetivo y repetir lo que se acordó. Cuando te responsabilizas por un nuevo proyecto se deben tener objetivos de diseño claros y acordados, que se deben decretar en un documento de especificación. Si el cliente no está de acuerdo con el documento de diseño, será mejor dejar el proyecto pues se tendrá dificultades en el futuro. El documento no precisa ser grande, debe ser una descripción de la aplicación deseada, los criterios de finalización y los hitos (Logros). Éste se conoce como Documento de Especificaciones Funcionales (requisitos y funciones) el cual debe ser firmado por ambas partes. Sin este documento existirán discrepancias con el cliente que puede llegar en una demanda y querrá que realice cambios sin pagar. Cuando surgen desacuerdos, puede consultar la especificación que el cliente aceptó y firmó, señalando que la ha cumplido al pie de la letra.  Hay que tener cuidado con la interfaz de usuarios, para evitar mal entendidos.

Para más información te comparto los siguientes links

Fox, C. (jun de 2015). toptal. Obtenido de https://www.toptal.com/freelance/why-design-documents-matter

Spolsky, J. (2 de octubre de 2000). Joel Spolsky. Obtenido de https://www.joelonsoftware.com/2000/10/03/painless-functional-specifications-part-2-whats-a-spec/