Home > Software Quality Tips > Software Requirements > Pictures communicate software requirements without slowing development
Software Quality Tips:
EMAIL THIS
 TIPS & NEWSLETTERS TOPICS 

SOFTWARE REQUIREMENTS

Pictures communicate software requirements without slowing development


Trevor Atkins, Contributor
11.21.2008
Rating: --- (out of 5)


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


[IMAGE] Without complete and clearly stated software requirements, software testers are unable to effectively perform their jobs of both verifying that the system was implemented correctly and validating that the correct system was implemented. This impairment also extends to responding to the need to accurately measure and report the test coverage of the system. Without documented requirements and the associated dependent artifacts, it is virtually impossible to properly answer questions such as the following:

Unless requirements can be traced accurately through the related project artifacts, such as business requirements, use cases, functional requirements, design specifications, code, test results, and defects, it is impossible to ensure that the system is being built for the intended purposes and tested adequately -- keeping the project on track and avoiding expensive rework later.

Of course, most projects will have some requirements information in some form -- whether it is formal specifications, wireframes, mock-ups, prototypes, dialog maps, content sheets, previous system releases, user manuals, or even stored in the minds of subject matter experts (SMEs). And it is very likely that the customer has contributed to the requirements by describing what they want from the system in terms of their business needs.

But the upfront time that it takes to document formal requirements properly and completely is often perceived as a barrier to avoid, even though it is easy to recognize that the proven savings downstream more than return the investment. In the rushed atmosphere of "We need to start coding and we need to start now", it is hard to convince anyone to take the time to perform "understood" formal documentation activities, let alone develop and apply a new documentation technique.

Balancing the need for fast development with requirements documentation
A balanced approach that maximizes the contribution of


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


RELATED CONTENT
Software Requirements
Requirements use cases tutorial: Advanced formats, test case comparisons
Use cases for software requirements tutorial: Strengths, flaws, formats
Quality assurance (QA) and testing's role in requirements
Defining requirements during software project feasibility analysis
Pros and cons of requirements-based software testing
How to avoid requirements creep
Making requirements walkthroughs more effective (and fun)
Using proactive test design methods to catch requirements issues early
REAL business requirements key to calculating ROI for a project
Approaches to defining requirements within Agile teams

Software Requirements Documentation
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
What should a business analyst's requirements document include?
Determining software testing deliverables for a small project
Using proactive test design methods to catch requirements issues early
How to determine a software modeling technique

Software requirements techniques (Prototyping, Storyboards, Modeling, State transitions)
Quality assurance (QA) and testing's role in requirements
Agile software development tutorial: Agile requirements gathering
Reporter's Notebook: Jack Vaughan on agile methodology
Pros and cons of requirements-based software testing
How to avoid requirements creep
Making requirements walkthroughs more effective (and fun)
Software development lifecycle (SDLC) trends 2009: Requirements, agile
Using proactive test design methods to catch requirements issues early
Is a requirements freeze in a software project a bad idea?
Requirements elicitation: Workshops vs. apprentice-style analysis

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


the organization's available resources within the project constraints is required. When you have minimal or out-of-date requirements, a first step in accelerating the capture of a useful understanding of the system and filling in the gaps regarding its purpose and functions is to think in pictures -- pictures that will form a basis for analysis and testing.

With this proven light-weight solution tailored to your timeframes and resource realities, testing is able to capture critical requirements information about the system without slowing development. The resulting artifacts can also serve as a direct input into testing activities, avoiding significant duplication of effort and possible confusions.

Flowcharts and state diagrams provide similar and, at times, complementary methods for visualizing, or picturing, the behavior and functionality of a system, establishing path coverage, and generating ideas for error path or negative testing. Through the rapid process of creating these diagrams and subsequently reviewing and clarifying them and their stories with stakeholders, test ideas will easily come to the fore for later execution.

Narrative user scenarios can be used to complement and expand upon what is provided in the diagrammatic representation. Adding checklists and matrices will further enable testing to be able to rapidly document the functionality to be tested and to be able to measure or assess the progress of that testing easily.

Using diagrams such as these can be very effective to visualize the system, not only for the tester but for the whole project team, and as long as you can capture the information you need to generate comprehensive, traceable test ideas, it doesn't matter what notation you use.

-----------------------------------------
About the author: Trevor Atkins is principal consultant with Silverpath Technologies. Most recently he was a regional director of quality services with UST Global, and before that he was a founder and the vice president of operations of QA Labs, the largest independent software testing company in Canada.


Rate this Tip
To rate tips, you must be a member of SearchSoftwareQuality.com.
Register now to start rating these tips. Log in if you are already a member.


Submit a Tip




DISCLAIMER: Our Tips Exchange is a forum for you to share technical advice and expertise with your peers and to learn from other enterprise IT professionals. TechTarget provides the infrastructure to facilitate this sharing of information. However, we cannot guarantee the accuracy or validity of the material submitted. You agree that your use of the Ask The Expert services and your reliance on any questions, answers, information or other materials received through this Web site is at your own risk.



Software Design & Testing - Project Management
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