Home > Ask the Software Quality Experts > Software Requirements Gathering, Analysis, Quality and Testing Questions & Answers > What should a business analyst's requirements document include?
Ask The Software Quality Expert: Questions & Answers
EMAIL THIS

What should a business analyst's requirements document include?

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: 18 January 2009
For a given software project, if the overarching audit department at our organization requires certain requirements to be met on the project (i.e, the use of a certain tool to manage project time, a project to have a clear quantifiable business objective documented and agreed to by the business, all contractual labor have a signed SOW, etc.), should the business analyst (BA) not capture these in their requirements document for the project? To me these are "project requirements" as stated by the audit department stakeholder and are required to be met by the project being undertaken. Please advise. I believe it's beneficial but am getting pushback from PLs. As a BA we want to ensure we capture all requirements for that project, both functionally and nonfunctionally.


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
Writing a software requirements specification (SRS) for a portal app
Should QA check changes from outside the requirements document?
Software testing metrics for a medium-sized project
Template for requirements use cases
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
Writing a software requirements specification (SRS) for a portal app
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
Determining software testing deliverables for a small project

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


If I'm understanding the question, it's referring to organizational requirements about the prescribed processes and procedures one must follow when performing any project in that organization. Ordinarily, such types of requirements would be maintained in a central manner for reference by participants on all projects. In this instance, it appears that the audit department is serving such a central role.

It doesn't hurt to note those project process requirements in the project documentation, but I think such note should be very brief and mainly refer back to the central posting. If use of particular project management tools is prescribed, then those tools should be used for capturing and updating relevant information about planned and actual tasks, resources and schedules involved in the business analysis. Statements of work (SOWs) are project management descriptions of the work to be carried out, such as to perform the business analysis and to implement a solution to meet the requirements identified in the business analysis. SOWs typically would not be included in the documents produced by a business analyst.

Typically, the bulk of the requirements a business analyst is charged with identifying relate to the project's content. Hopefully the organization understands that chances of project success are improved dramatically by first adequately identifying the REAL business requirements. Identifying clear quantifiable business objectives is a necessary start. It's important that the objectives be accurate, which too often is not the case and unfortunately is seldom recognized.

Realize that the objectives alone are not the REAL business requirements and are not sufficient for designing a product/system/software solution. Rather, REAL business requirements are business deliverable whats that provide value by achieving the objectives when delivered by a product/system/software solution how.

Such whats include business functionality, business rules and quality factors (which often are referred to, inappropriately I believe, as "nonfunctional") such as usability, security and performance. The whats need to be driven selectively down to further detail where they are sufficiently clear and complete. No matter how far down in detail they go, they continue to be business deliverable whats and never turn into hows. The hows are a response to the whats, which is why it's so important to first identify and detail those business requirements.




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