Home > Ask the Software Quality Experts > Software Requirements Gathering, Analysis, Quality and Testing Questions & Answers > Writing a software requirements specification (SRS) for a portal app
Ask The Software Quality Expert: Questions & Answers
EMAIL THIS

Writing a software requirements specification (SRS) for a portal app

Robin F. Goldsmith EXPERT RESPONSE FROM: Robin F. Goldsmith

Pose a Question
Other Software Quality Categories
Meet all Software Quality Experts
Become an Expert for this site


Software quality news and advice
Digg This!    StumbleUpon Toolbar StumbleUpon    Bookmark with Delicious Del.icio.us    Add to Google


>
QUESTION POSED ON: 09 April 2009
Could you please tell me how to prepare an SRS for a business portal application?


Digg This!    StumbleUpon Toolbar StumbleUpon    Bookmark with Delicious Del.icio.us    Add to Google



RELATED CONTENT
Software Requirements Gathering, Analysis, Quality and Testing
Problems caused by skipping analysis stage of SDLC
Software development life cycle phases, iterations, explained step by step
Waterfall versus iterative development misconceptions
Differentiating between Functional and Nonfunctional Requirements
Should QA check changes from outside the requirements document?
Software testing metrics for a medium-sized project
Template for requirements use cases
What should a business analyst's requirements document include?
Is a requirements freeze in a software project a bad idea?
Requirements elicitation: Workshops vs. apprentice-style analysis

Software Requirements Documentation
VisibleThread aims to boost IT documentation quality, improve processes
When it comes to requirements, what is 'just enough'?
How to deliver, implement testable software requirements
Blueprint rolls out Requirements Center 2010
Should QA check changes from outside the requirements document?
Agile software development tutorial: Agile requirements gathering
Defining requirements during software project feasibility analysis
Template for requirements use cases
What should a business analyst's requirements document include?
Determining software testing deliverables for a small project

Use cases and misuse cases
Requirements practices evolving, but organizations still struggle
Defining report requirements with use cases
How requirements use cases facilitate the SDLC
Excelling in the art and science of requirements elicitation
Requirements use cases tutorial: Advanced formats, test case comparisons
Use cases for software requirements tutorial: Strengths, flaws, formats
Agile software development tutorial: Agile requirements gathering
Pros and cons of requirements-based software testing
How to avoid requirements creep
Template for requirements use cases

RELATED GLOSSARY TERMS
Terms from Whatis.com − the technology online dictionary
functional specification  (SearchSoftwareQuality.com)
requirements analysis  (SearchSoftwareQuality.com)
Software Engineering Institute (SEI)  (SearchSoftwareQuality.com)
software requirements specification  (SearchSoftwareQuality.com)
Wirth's Law  (SearchSoftwareQuality.com)

RELATED RESOURCES
2020software.com, trial software downloads for accounting software, ERP software, CRM software and business software systems
Search Bitpipe.com for the latest white papers and business webcasts
Whatis.com, the online computer dictionary


A software requirements specification (SRS) describes the requirements of a software product -- what it must do in order to function as expected. Realize that despite using the term "requirements," an SRS really is high-level design how of a product whose expected functioning is a presumed way to satisfy the REAL business requirements deliverable whats that provide value when satisfied. The software can work as expected but won't provide value unless it actually satisfies the REAL business requirements.

While a number of authors and organizations suggest SRS formats, many of which can be found through search engines, the most widely known version is described in IEEE Std. 830-1998. Standards can be purchased for what seems to have become much, much higher prices than I recall paying a few years ago. I'm appalled that it now costs $102 at http://webstore.ansi.org and at www.ieee.org, where IEEE members can buy it for $81. IEEE used to publish a very reasonably priced collection of several standards related to information systems, including 830; but the most recent used edition that I found listed on Amazon.com was from 1985. A number of books which Amazon also lists when you search for "IEEE 830" can be purchased for much less and describe the standard, and I suspect some may even reproduce the standard in its entirety.

The standard prescribes a format with a large number of separate sections, each addressing a different aspect of the software requirements. The prescribed SRS format is identical regardless of the software's use. That is, one prepares an SRS for a business portal essentially the same way one prepares an SRS for any other application.

The strength of the SRS is that the various sections are like a checklist to help assure you've addressed relevant topics, such as:

  • Purpose, Scope, Definitions, References, Overview
  • Product Perspective, Product Functions, User Characteristics, General Constraints, Assumptions and Dependencies
  • Each Functional Requirement -- Introduction, Inputs, Processing, Outputs
  • External Interface Requirements -- User, Hardware, Software, Communications
  • Performance Requirements
  • Design Constraints, Standards Compliance, Hardware Limitations
  • Attributes (often called "nonfunctional requirements," "quality factors" or "ilities") such as Usability, Reliability, Maintainability and Security
  • Other relevant requirements, such as for Database, Operations and Site Adaptation

Those who use SRSs frequently complain that the many sections lead to excessively lengthy documents which take too much time to prepare. Also, the SRS's multi-sectional format, which I liken to pigeon holes, can interfere with understandability because it can be easy to lose track of items in separate sections which need to be dealt with together.

The bigger issue is that SRSs not only don't assure that REAL business requirements are identified, but the common perception that an SRS is the requirements essentially assures that REAL business requirements won't be identified. An SRS's Purpose section is typically a few sentences describing desired value to be obtained, but it doesn't describe the business deliverable whats that will provide that value when delivered by the software product how. Creep mainly occurs when the product described in the SRS turns out not to be what's really needed -- that is, it fails to meet the REAL business requirements because they weren't defined adequately.

So, the way to prepare an SRS for a business portal is first to identify the REAL business requirements that the portal needs to accomplish. Many of the SRS topics do need to be addressed, but from a business and value standpoint. Then determine how best to address them, which may or may not turn out to be a business portal. Describe how the solution you want to implement should function in an SRS. You may also then want to write some use cases to describe the usage of it.




Search and Browse the Expert Answer Center
Search and browse more than 25,000 question and answer pairs from more than 250 TechTarget industry experts.
Browse our Expert Advice



Software Quality - Software Maintenance, Software Requirements, Software Standards
About Us  |  Contact Us  |  For Advertisers  |  For Business Partners  |  Site Index  |  RSS
SEARCH 
TechTarget provides technology professionals with the information they need to perform their jobs - from developing strategy, to making cost-effective purchase decisions and managing their organizations' technology projects - with its network of technology-specific websites, events and online magazines.

TechTarget Corporate Web Site  |  Media Kits  |  Site Map




All Rights Reserved, Copyright 2006 - 2009, TechTarget | Read our Privacy Policy
  TechTarget - The IT Media ROI Experts