¿Cómo etiquetar los requisitos de software?

¿Cuál es una buena estrategia para etiquetar los requisitos de software en un SRS?

Por lo general, la numeración del esquema se emplea en los encabezados, pero estos se volverán a numerar si se inserta un nuevo encabezado en el documento. Para mí, parece una buena idea apuntar a una designación más estable para cada requisito de software. Esto debería facilitar la referencia a un requisito particular incluso ante un SRS actualizado.

¿Cuáles son tus experiencias en esto?

Una estrategia:

1. Considere la ID de SRS como solo un número y no implique ninguna noción fuerte de orden consecutivo (el número de seguro social es un ejemplo razonable).
2. No recicle los números. Cuando se elimina un ID en una secuencia, márquelo "Eliminado", "Desaprobado", etc. Prefiero mantener el texto del requisito en el elemento eliminado para tener un registro de la evolución del requisito. Si elige hacer esto, marque el texto eliminado obviamente, por ejemplo, una fuente tachada.
3. # 2 implica que las nuevas adiciones de requisitos nunca ocurrirán "en su lugar"; más bien, siempre se adjuntan al documento.
4. Esta estrategia puede ser difícil de organizar o agrupar jerárquicamente a medida que se acumulan los cambios, por lo tanto, etiquete cada ID de SRS con una etiqueta significativa para la búsqueda, es decir, [GUI], [DB], etc.

Existen otras estrategias, como el uso de decimales punteados para agrupar los requisitos, por ejemplo:

• 1.0 GUI
• 2.0 DB
• 3.0 Procesamiento

Como puede suponer, los requisitos respectivos deben ordenarse bajo el número de nivel superior en consecuencia: 1.1, 1.2 ... para GUI, 2.1, 2.3, 2.4 para DB, etc. Tenga en cuenta que esta estrategia necesitará algún tipo de método controlado para gestión de eliminaciones y adiciones.

La clave para hacer cumplir en un documento de requisitos: una vez que se ha utilizado una ID para un requisito, no se puede volver a utilizar un requisito diferente. En otras palabras, si se usó SRS 1234 y luego se eliminó, no puede volver a aparecer más tarde. (Permitirlo provoca estragos absolutos en la trazabilidad de los requisitos en el transcurso de un proyecto en evolución).

Tenga en cuenta que prácticamente cualquier organización / estructura de SRS tendrá deficiencias. Elija el que se adapte a su entorno de desarrollo y a las necesidades de su aplicación. (Por ejemplo, las estrategias anteriores funcionan razonablemente bien en entornos de desarrollo altamente controlados, como los supervisados ​​por la FDA u otros organismos gubernamentales).

Finalmente, considere usar una herramienta de gestión de requisitos. Hay algunos buenos (código abierto para $$$$$) que se encargarán de todo esto por usted.

El mejor pensamiento conceptual es que los requisitos son elementos distintos, relacionados entre sí de varias maneras y, por lo tanto, deben almacenarse en una base de datos. Usar un procesador de texto para almacenar requisitos es la forma incorrecta y genera muchos problemas, ya que genera el pensamiento conceptual de que "los requisitos son un documento", de ahí esta pregunta. Si debe usar un procesador de texto, mantenga cada requisito por separado, tal como lo haría si usara Word para almacenar contactos.

Por lo tanto, usar la numeración del esquema para mantener los requisitos causará problemas. ¿Se imagina tratando de cruzar la prueba de referencia y los requisitos SRS y del cliente si cambia los números? Imagine discutir el "Requisito 10.2.3.1" solo para descubrir que en el documento de ayer que envió al cliente era "10.2.2.1"

Los requisitos son una etiqueta y deben transmitir poco significado. Es posible que tenga uno o algunos prefijos cortos de 2 a 5 letras para identificar el alcance o la unidad, pero para cuando tenga varios miles, cualquier significado implícito debe ser limitado. Por ejemplo, en un automóvil puede tener EM-FUEL-1234 (Gestión del motor, sistema de control de combustible, requisito 1234).

Los requisitos deben poder reutilizarse en todos los proyectos.

Los requisitos deben ser únicos, a lo largo del alcance y la vida del proyecto. Como guía, cambiar un requisito para aclarar es el mismo número, pero para cambiarlo significativamente, elimine el antiguo y reemplácelo. Usar un esquema de versión (anexar_1, _2, etc.) puede ser útil.

Si debe usar Word para almacenar esta base de datos, una buena manera es usar tokens de inicio y fin para identificar los requisitos. Si utiliza un estilo de fuente único para la numeración de requisitos, resulta fácil resaltarlos, buscarlos y extraerlos utilizando macros (tal vez en una base de datos). Ejemplo podría ser

#Req 1234 #

Bla bla bla bla

# ReqEnd #

#Req 1234a #

Bla bla bla bla y más bla

# ReqEnd #