La documentacion es importante

¿Porque debemos documentar?

Durante el desarrollo de un proyecto de TI es importante tener documentación del mismo no solo porque con esta puedes tener respaldo de lo que se esta haciendo y como, puesto que esta es tu respaldo principal de todo el proyecto de quien hace que y quien lo acredita como bueno para que al final no tengas problemas con que no hiciste nada, ademas de que esta al ser consultada por los clientes pueden tener una idea mas clara y precisa de todo el proyecto, desde los diagramas base de datos, script, interfaces, requerimientos, matrices, entre muchos otros mas entregables del proyecto.

Por qué los documentos de diseño de software importan

Cuando empiezas un nuevo proyecto, antes de empezar a tirar código o diseñar base de datos como el experto que eres debes tener objetivos de diseño claros y acordados ya sea por tu líder y tu cliente o por un grupo de encargados en el área y estos objetivos deberían establecerse en un documento de “especificación de requerimientos”.

Los documentos de diseño se deben especificar de manera especial y detallada, pueden ser solo unas pocas páginas, pero al menos debe establecer la interfaz de usuario. Sin este documento, terminarás cometiendo un montón de  equivocaciones con lo cual los clientes estarán muy insatisfechos que quieran cambios que la aplicación cumpla con lo que en realidad querían y pidieron y espera que realice esos cambios sin pagar.

Con estos documentos de diseño de software se tiene una respuesta a cualquier objeción además deben estar firmados de preferencia para evitar que surjan desacuerdos se puedan consultar las especificaciones que el cliente aceptó y firmó, señalando que la ha cumplido al pie de la letra.

En lugar de argumentos enojados, hará enmiendas y aclaraciones al documento. En todo caso, el cliente se disculpará por permitir que la imprecisión se deslice en primer lugar.

Una descripción de la aplicación deseada, los criterios de finalización lo que mejor se describe como un documento de requisitos y funciones, no como una especificación de implementación la forma en que lo haga funcionar depende de usted.

Interfaz de usuario

La mayoría de los proyectos de hoy en dia son aplicaciones multi dispositivos ya no solo son portales web o aplicaciones de escritorio entonces las interfaces ahora juegan un papel muy importante en su desarrollo entonces ten en cuenta esto la interfaz de usuario es, uno de los componentes más problemáticos durante el desarrollo de su plantilla de documento de diseño y casi siempre conduce a malentendidos porque esta puede cambiar múltiples veces porque en algunos casos los clientes envían diseños creados por un diseñador grafico que no es un programador porque en un punto estos bocetos no dicen nada sobre las animaciones, los estados de control o incluso qué acciones realizar cuando se presiona un botón entonces se tienen que hacer cambios o opciones diversas para cada uno de los mismo.

Funcionalidad

Preguntas clave para hacer en el documento de diseño de la aplicación:

1. ¿Qué hace la aplicación y qué tan rápido lo hace?
2. ¿Cuáles son las posibles condiciones de falla y cómo se manejan?
3. ¿Qué operaciones únicas se realizan en la primera ejecución (es decir, después de la instalación)?
4. Si el usuario crea entradas de cualquier tipo (por ejemplo, marcadores), ¿cuáles son las limitaciones?

Siempre ten preguntas para las interfaces.