¿Qué hace que una gran especificación funcional sea genial?

Question

¿Qué cualidades lo hicieron tan bueno y qué lo hizo destacar en comparación con las especificaciones no tan buenas con las que tuvo que lidiar? O bien, si nunca antes trabajó con una buena especificación funcional, ¿qué tipo de cosas esperaría en una gran especificación?

Lo siento, esto es obviamente subjetivo, pero estoy creando una especificación funcional (no la primera) y se me ocurrió que puedo obtener algunas buenas ideas de las personas brillantes en SO!

Answer 1

Las especificaciones Project Aardvark de Joel en Software son las mejores que he encontrado hasta ahora. Cada pantalla se define muy bien, con imágenes. Se describen las principales características del software, así como algunos detalles técnicos.

Lamentablemente las especificaciones que he recibido personalmente no son tan brillantes. Por lo general, son solo una lista con viñetas de las características que esperan de cada sección del sistema, y ​​esperan que usted resuelva todos los detalles. Lo cual está bien, supongo. Sin embargo, estoy escribiendo un documento de diseño de juego para un juego de RPG en el que estoy trabajando como proyecto personal, y creo que las especificaciones que estoy escribiendo están muy bien escritas. He dividido el juego en secciones como

• Caracteres
• Armas & Armor
• Niveles
• Mapa
• Física

y así sucesivamente, y se describen en cada sección términos de juego, así como algunos detalles técnicos. Es muy fácil de trabajar.

También recomiendo leer el Painless Functional Specs Series de Joel on Software para cualquier persona interesada en escribir mejores especificaciones.

Answer 2

Obviamente, la especificación debe ser completa, consistente y comprensible. IMO también debe estar bien organizado, ya que mantiene todos los requisitos para una parte específica del producto. He leído más de una vez especificaciones en las que los requisitos para algún módulo estaban dispersos en todo el documento, p. la descripción general se encuentra en el capítulo 4, pero se pueden encontrar requisitos adicionales en las cláusulas de los capítulos 2, 5, 7 y apéndice B. Para trabajar con dicha especificación, primero tengo que crear un mapa de referencia cruzada de requisitos para los módulos.

Answer 3

En mi humilde opinión, una característica clave debería ser que la especificación funcional especifica el "qué" en gran detalle pero no el "cómo". De esta forma, el solicitante (¿de comercialización?) Obtiene el aspecto & y el conjunto de características que desean, pero la implementación se deja a quienes mejor lo conocen: los desarrolladores.

Answer 4

Una buena especificación debe indicar lo que se supone que debe hacer la aplicación, de manera clara.

Esto parece obvio, pero las cosas que suelo obtener suelen ser muy vagas. Aparentemente, no es muy fácil para las personas expresar lo que quieren en papel, SI incluso saben lo que quieren.