Modelli di Specifiche Tecniche e Funzionali [chiuso]

Question

Quindi fondamentalmente sto cercando buoni modelli per scrivere specifiche tecniche e funzionali su un progetto o una richiesta di lavoro.

Cosa usi?Quanto approfondisci mentre scrivi le specifiche?Eventuali ulteriori suggerimenti generali che potresti fornire sarebbero apprezzati.

La mia azienda ne ha un disperato bisogno.Lavoro per un appaltatore e al momento non utilizziamo affatto questi documenti.

MODIFICARE: Ho letto l'opinione di Joel Specifica indolore, mi è piaciuto davvero, ma ci sono altre opinioni :)

Answer 1

Sui consigli generali;

Stiamo implementando un processo di

1) Dichiarazione dei requisiti aziendali (BRS)

2) Specifica funzionale

3) Specifica tecnica

Il BRS copre quali sono i problemi aziendali e quali sono i requisiti relativi a soluzioni, test, sicurezza, affidabilità e consegna.Questo definisce ciò che renderebbe una soluzione di successo.

Le specifiche funzionali descrivono in dettaglio cosa è necessario, come dovrebbe apparire, quanto dovrebbero essere lunghi i campi, ecc.

Le specifiche tecniche specificano da dove provengono i dati e qualsiasi codice complicato che potrebbe dover essere preso in considerazione.

Il cliente possiede i requisiti.Gli sviluppatori possiedono le specifiche tecniche e le specifiche funzionali sono una via di mezzo.Il test viene eseguito rispetto alle specifiche tecniche (solitamente test unitari), quindi rispetto alle specifiche funzionali (solitamente test di sistema) e infine rispetto ai requisiti (UAT).

La parte importante di questo (e con cui stiamo lottando) è che gli sviluppatori devono ancora rispettare le specifiche funzionali e i requisiti aziendali originali.In realtà le specifiche funzionali e tecniche sono lì solo per chiarezza.

In breve, il mio consiglio principale è quello di elaborare prima il processo che desideri implementare.Quindi cerca l'accordo di tutte le parti coinvolte nel processo proposto, quindi lavora sui modelli che si adattano.I modelli stessi sono solo una piccola parte della modifica che desideri apportare.

Answer 2

Non un modello, ma Joel ne ha scritto uno paio di articoli sulla scrittura di una specifica funzionale.Anche lui lo ha fatto campione qui.

Answer 3

Puoi acquistare modelli da ieee e da altri posti, ma alla fine ho sempre creato i miei.

Per una specifica tecnica, "Codice completato" di Steve McDonnell ha una buona lista di controllo, puoi trarne alcune informazioni.Nel mio ultimo lavoro, ho semplicemente creato un modello partendo dalle intestazioni delle sue sezioni e l'ho modificato da lì.

Per quanto riguarda le specifiche funzionali, l'importante è definire tutte le interfacce:

1. Interfaccia utente (mockup di schermate)
2. Interfacce software (plugin, ecc.)
3. Interfacce hardware (se appropriate)
4. Interfacce di comunicazione (Servizi, email, messaggistica, ecc.)

Dovrebbe esserci anche una sezione per le regole aziendali, cose importanti dal punto di vista funzionale che non sono coperte da alcuna definizione di interfaccia.

Answer 4

Se vuoi acquistare un libro, Requisiti software di Karl Wiegers ha modelli per alcuni documenti come appendice.Sfortunatamente sono al lavoro e quel libro in particolare è a casa.Se qualcuno lo ha a portata di mano potrebbe confermarlo.

Answer 5

Mi è piaciuto questo, tra gli altri: Pronti, partenza.

Vende anche una versione pro.

Answer 6

Questo è il migliore che ho trovato: http://www.jiludwig.com/templates/FRDTemplate.doc

Answer 7

Inizia in modo semplice e procedi da lì.Poiché questa è la tua prima esperienza con questo strumento, utilizza un documento Word con elenchi puntati.Scrivilo, rileggilo e fornisci dettagli sufficienti affinché abbia senso.Per le specifiche tecniche, potresti voler guidare lo sviluppatore verso una soluzione, ma per le specifiche funzionali il "come" dovrebbe mancare completamente.

Answer 8

Suggerirei di dare un'occhiata al modello Volere di Roberston Qui.Fanno parte della Atlantic Systems Guild, insieme a persone come Tom DeMarco e Timothy Lister famosi per "Peopleware".

Poiché il modello è protetto da copyright, non lo riprodurrò qui, ma ti fornirò alcune delle intestazioni principali:

1. Lo scopo del progetto
2. Le parti interessate
3. Vincoli obbligatori
4. Convenzioni di denominazione e terminologia
5. Fatti e ipotesi rilevanti
6. Lo scopo del lavoro
7. Modello di dati aziendali e dizionario dei dati
8. L'ambito del prodotto
9. Richieste funzionali
10. Guarda e sente requisiti ...

Ce ne sono molti altri, ma questo dovrebbe darti un'idea.La parte più interessante del modello è la shell dei requisiti che elenca i requisiti funzionali su una sorta di cue card.Ancora una volta protetto da copyright, ma davvero prezioso.

Aspetto Qui nel capitolo 9.