Come si scrive una specifica funzionale in modo rapido ed efficiente

Hai letto parte 2 dell'articolo o il suo specifiche campione ? Rappresentano un paio di importanti principi quando si scrive una specifica.

• Non sovradimensionare. Lo scopo di scrivere le specifiche è di costringerti a pensare a cose importanti come quello che succede quando c'è un errore, e come ti aspetti che l'utente interagisca con il sistema. Non devi entrare in dettagli eccessivi per ottenere qualcosa da cui puoi lavorare. Hai bisogno di dettagli, però.
• Si tratta di comunicazione. Lo scopo delle specifiche è di raggiungere un accordo comune su ciò che deve essere fatto. Non è un documento corazzato che richiede la forza della legge. È uno strumento che ti aiuta a capire meglio il tuo cliente e il tuo cliente per capire meglio cosa vuoi fare per loro.

Il miglior consiglio è quello di scrivere abbastanza in modo da essere chiari su ciò che devi fare. Se hai domande aperte, documentale nelle specifiche e ottieni le risposte dal tuo cliente. Una volta che hai adeguatamente capito cosa è necessario stop .

Se non stai attento, il documento assumerà una vita propria. Dovrebbe avere uno scopo, non aggiungere nulla al documento che non si adatta a questo scopo. Dovrebbe essere facile da mantenere. Se hai gli interi diagrammi dettagliati delle classi, insieme ad altri dettagli che appartengono davvero a un test unitario, abbandonerai il documento perché la manutenzione è eccessiva, altrimenti il progetto non verrà completato.

Informazioni sulla scrittura

Scrivere per le persone è difficile . In effetti, le due cose più difficili della scrittura sono sapere come iniziare e sapere quando smettere . All'inizio devi solo fare qualcosa. Il mio consiglio per affrontare questi due aspetti più difficili è:

• Conosci il tuo pubblico. Chi dovrebbe leggere le specifiche? Se sei solo tu e il cliente, ecco a chi stai scrivendo. Se hai qualcuno responsabile dei test, avrai anche delle note per loro.
• Inizia con la priorità più alta. Mentre l'autenticazione è importante, la schermata di accesso è probabilmente il pezzo più comprensibile che la maggior parte della gente deve scrivere. Concentrati invece su quella funzione di cui i tuoi utenti hanno più bisogno. Sai, quella parte che fa guadagnare denaro ed è l'intera ragione per cui hanno bisogno del software.
• Compila i dettagli mentre le domande vengono visualizzate e ottieni le risposte. Mantieni le cose davvero semplici con i disegni a tovagliolo, se necessario, finché il cliente non è soddisfatto della sistemazione. È importante sapere quali informazioni sono coinvolte e come verranno utilizzate.
• Interrompi quando aggiungi altro non aggiunge valore. Ci sono alcuni dettagli che non vuoi in una specifica. Devi sapere quando hai la cosa giusta. Non è necessario sapere che esiste una variabile all'interno di un metodo chiamato "albaquerque". Questo è il codice sorgente, non le specifiche.