Buenas practicas - lecciones aprendidas en la especificaciones de requerimientos

Original: http://miaton.blogspot.com/2008/02/buenas-practicas-lecciones-aprendidas.html

Buenas practicas - lecciones aprendidas en la especificaciones de requerimientos
Definición
Un requerimiento es la condición o capacidad que necesita el usuario para resolver un problema o alcanzar un objetivo. Es la condición o capacidad que debe satisfacer o poseer un sistema o una componente de unsistema para satisfacer un contrato, un standard, una especificación u otro documento formalmente impuesto [IEEE610].

Recomendaciones / sugerencias para el documento de requerimientos
"La experiencia es la mejor escuela para escribir requerimientos adecuados"
- Wiegers
Oraciones con gramática, sintaxis y puntuación adecuada
Oraciones cortas y directas
Voz activa, imperativos: "el sistema debehacer algo" y no "algo debe hacerse"
Usar los términos consistentemente y de acuerdo a la definición del glosario
No use sinónimos: no varíe el lenguaje para atraer al lector
Descomponga un requerimiento de alto nivel en detalle suficiente para clarificarlo y eliminar la ambigüedad
Use una forma consistente de redactar: "el sistema debe"+verbo
Especifique la acción que dispara elcomportamiento del sistema
Evite el "debería", "podría" y condicionales
En "El usuario debe..." especifique al usuario: "El cajero debe..."
Presente información visualmente, las masas de texto no ayudan
Enfatice la información más importante
Términos ambiguos y su modificación
Término ambiguo Formas de mejorarlo
aceptable, adecuado Defina qué constituye la aceptabilidad y cómo el sistema la juzgatanto como sea practicable No deje en manos de los desarrolladores determinar qué es practicable.
al menos, como mínimo, no más que, no exceder Especificar los valores mínimos y máximos aceptables
Entre Defina si los puntos extremos están o no en el rango
depende de Describa la naturaleza de la dependencia. ¿Otro sistema provee input a este sistema, debe instalarse otro sistema antes que susofwtware sea ejecutado o su sistem depende de otro para ejecutar algún cálculo o servicio?
Eficiente Defina como el sistema usa eficientemente recursos, cuan rápidamente ejecuta operaciones o como es de fácil para la gente usarlo
rápido, veloz Especifique la mínima velocidad aceptable a la que el sistema ejecuta alguna acción
Flexible Describa las formas en la que el sistema debe cambiar en respuestaa condiciones cambiantes o necesidades del negocio
mejorado, mejor, más rápido, superior Cuantifique cuanto mejor o más rápido constituye una mejora adecuada en un área funcional específica
incluyendo, incluyendo pero no limitado a, y así sucesivamente, etc. tal como La lista de ítems debería incluir todas las posibilidades. De otro modo no podría usarse para diseño o testeo
maximice,minimice, optimice Establezca los valores máximo y mínimo aceptable para algún parámetro
normalmente, idealmente Describa también el comportamiento del sistema bajo condiciones anormales o no-ideales
Opcionalmente Clarifique si se trata de una opción del sistema, del usuario o del desarrollador
razonable, cuando es necesario, donde sea apropiado Explique como se produce este juicio
Robusto Defina comoel sistema maneja las excepciones y responde a condiciones operacionales no esperadas
transparente, suave, grácil Traduzca las expectativas del usuario en caracterísrticas observables del producto
Varios Establezca cuantos o proveea las cotas mínima y máxima del rango
no debería Establezca los requerimientos positivos, diciendo que hará el sistema
estado del arte Defina qué significaSuficiente Explique con cuanto de algo se establece la suficiencia
soporte, disponible Defina exactamente que funciones debe ejecutar el sistema que soporten alguna capacidad
Amistoso, fácil, simple Describa las características del sistema que alcanzarán las necesidades de uso del usuario y las expectativas de usabilidad

Características de una buena especificación de requerimientos - factores de...