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

Posted on 2006-05-04
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 65

    Accepted Solution

    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
    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

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

    Assisted Solution

    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

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

    Write Comment

    Please enter a first name

    Please enter a last name

    We will never share this with anyone.

    Featured Post

    Top 6 Sources for Identifying Threat Actor TTPs

    Understanding your enemy is essential. These six sources will help you identify the most popular threat actor tactics, techniques, and procedures (TTPs).

    Does the idea of dealing with bits scare or confuse you? Does it seem like a waste of time in an age where we all have terabytes of storage? If so, you're missing out on one of the core tools in every professional programmer's toolbox. Learn how to …
    Whether you’re a college noob or a soon-to-be pro, these tips are sure to help you in your journey to becoming a programming ninja and stand out from the crowd.
    In this fourth video of the Xpdf series, we discuss and demonstrate the PDFinfo utility, which retrieves the contents of a PDF's Info Dictionary, as well as some other information, including the page count. We show how to isolate the page count in a…
    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…

    759 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

    Need Help in Real-Time?

    Connect with top rated Experts

    10 Experts available now in Live!

    Get 1:1 Help Now