kind of diagrams that should be in a Software requirements specs?

Posted on 2006-05-04
Medium Priority
Last Modified: 2010-04-17
What kind of diagrams should i include in a S/W requirements specs? UCASE? SEQUENCE? DFD? ER?

I need a s/w req. specs for web portal...or web site...pls help.
Question by:spiral
LVL 66

Accepted Solution

Jim Horn earned 172 total points
ID: 16608198
Off the top of my head..

Problem description
Two-sentance description of what needs to be built
In Scope
Out of Scope   '<--- Most important part of requirements doc, trust me on this one
Rough timeline
Rough who needs to be involved + time commitment of each
Account number to charge project to.  '<--- Second most important part of requirements doc
LVL 55

Assisted Solution

by:Jaime Olivares
Jaime Olivares earned 164 total points
ID: 16608261
I suggest you to use UML.
The most important diagram to start is Use Cases.
Depending on how many you want to detail your specs, Class Diagrams and State Diagrams would be useful.
I suggest you to read this book:
"UML Xtra-Light: How to Specify Your Software Requirements"

Author Comment

ID: 16611515
i dun have that book
UML Xtra-Light: How to Specify Your Software Requirements

Assisted Solution

Sowmya_K earned 164 total points
ID: 16615880
I would suggest you to use a use case diagram.

A use case is a technique for capturing the potential requirements of a new system or software change. Each use case provides one or more scenarios that convey how the system should interact with the end user or another system to achieve a specific business goal. Use cases typically avoid technical jargon, preferring instead the language of the end user or domain expert. Use cases are often co-authored by software developers and end users.

Use cases treat the system as a "black box", and the interactions with system, including system responses, are as perceived from outside the system. This is deliberate policy, because it simplifies the description of requirements, and avoids the trap of making assumptions about how this functionality will be accomplished.

A use case should:
*describe a business task to serve a business goal
*be at the appropriate level of detail
*be short enough to implement by one software developer in single release.
Use cases can be very good for establishing the functional requirements; however they are not suited to capturing Non-Functional Requirements.


Author Comment

ID: 16624749
anyone got a software requirement specs template for a website which i can use? i m pretty new in this document. thanks.

Featured Post

Technology Partners: We Want Your Opinion!

We value your feedback.

Take our survey and automatically be enter to win anyone of the following:
Yeti Cooler, Amazon eGift Card, and Movie eGift Card!

Question has a verified solution.

If you are experiencing a similar issue, please ask a related question

In this post we will learn different types of Android Layout and some basics of an Android App.
What do responsible coders do? They don't take detrimental shortcuts. They do take reasonable security precautions, create important automation, implement sufficient logging, fix things they break, and care about users.
In this fifth video of the Xpdf series, we discuss and demonstrate the PDFdetach utility, which is able to list and, more importantly, extract attachments that are embedded in PDF files. It does this via a command line interface, making it suitable …
In this seventh video of the Xpdf series, we discuss and demonstrate the PDFfonts utility, which lists all the fonts used in a PDF file. It does this via a command line interface, making it suitable for use in programs, scripts, batch files — any pl…

850 members asked questions and received personalized solutions in the past 7 days.

Join the community of 500,000 technology professionals and ask your questions.

Join & Ask a Question