Home > Ask the Software Quality Experts > Software Testing and Quality Assurance Questions & Answers > The value of documenting test case results
Ask The Software Quality Expert: Questions & Answers
EMAIL THIS

The value of documenting test case results

Karen N. Johnson EXPERT RESPONSE FROM: Karen N. Johnson

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 June 2007
What is the value proposition I can offer our developers and customers when persuading them to do a better job at documenting expected and actual results in their test cases? We exist in an environment where developers perform the tests up to UAT, developers and customers are domain experts, there is little turnover, and many have the luxury of allowing the customer to identify new requirements via testing. These facts cancel most of the benefits I can enumerate. The remaining benefit that can be argued is that they will avoid discipline when they fail a Sarbanes-Oxley audit for failing to produce independently verifiable test cases.

>
EXPERT RESPONSE

Since the term test case means different things to different people, let me clarify my use of the term in this response. A test case would identify a series of steps or actions and the expected system response. Given this description, there may be multiple advantages to document expected and actual results. Here are a few:

In the case of developers performing testing up until user acceptance testing (UAT), it may be unclear what was tested and what results were perceived as acceptable or not. In other words documenting expected and actual results would be one way someone other than the developer who executed the testing could review the testing and understand what results were viewed as acceptable. I could envision an opportunity where a developer thinks the actual results were acceptable but someone else on the team (including customers) might not agree. How would the results be understood if the information wasn't documented or wasn't provided through an extensive debriefing session? The benefit is clarity and documentation. The documentation will provide an opportunity for a test review that might be impossible otherwise.

The fact that there has been low turnover is great but doesn't mean it's been no turnover or that multiple people in the environment couldn't change jobs. The reality is that we have to plan on people not staying at the same job for extended periods, which drives the need for documentation up -- not away. If you consider someone or multiple people on the development team leaving, would you be able to replace that knowledge painlessly? If not, then it might be a good time to begin documenting test actions, expected results and actual results.

An audit isn't the only reason to document information, but an audit is a good reason. The expected benefit is that an auditor will be able to step into the environment and make assessments of the testing that has been executed. If a product must comply with audit regulations, then documented test cases is a requirement. Whether it's a benefit or not is not the relevant point or primary concern. If your test cases are required, then you might as well put solid effort into making the test cases clear and reusable.

Software testing resources:
User acceptance testing and test cases

How to design test cases

Software testing deliverables: From test plans to status reports

Another reason to document expected and actual results is to help your customers. I've seen end users equipped with full knowledge of a product, but when it comes time to test they freeze. They're not used to testing, they're not sure what to do and in these instances, documented test cases provide guidance. These are the testers that will view a test case and continue to add their own ideas as they test for product acceptance. If your customers who perform UAT could view what's already been tested then they can jump ahead and test other areas. In this case, overall test coverage could be improved by each person knowing what the other person has already accomplished.


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


RELATED CONTENT
Software Testing and Quality Assurance
Should you retest closed defects during regression testing?
Common mistakes of new software testers
How to test an application's scalability, performance
Integration testing: Is it black box or white box testing?
Test strategy document vs. an acceptance test plan
The future of software testing
Quality assurance testing vs. user acceptance testing
Eliminating testing environment troubles
How to use tools for system integration testing
How to match the test environment to the production environment

User acceptance testing
Quality assurance testing vs. user acceptance testing
Overcoming user acceptance testing difficulties
Running UAT and system testing in parallel
Test metrics and use case coverage during testing
Acceptance testing for websites
The benefits of user acceptance testing
The scope of user acceptance testing
Software testing fundamentals: User acceptance testing
Six functional tests to ensure software quality
The user acceptance testing (UAT) team is your ally

Software testing and quality assurance (QA) fundamentals
Pictures communicate software requirements without slowing development
Common mistakes of new software testers
Cloud computing creates software testing challenges
How cloud computing affects agile practices, testing
Test strategy document vs. an acceptance test plan
SOA application testing a combined effort
Overcoming SOA testing challenges
The future of software testing
Eliminating testing environment troubles
How to match the test environment to the production environment

RELATED GLOSSARY TERMS
Terms from Whatis.com − the technology online dictionary
build  (SearchSoftwareQuality.com)
code review  (SearchSoftwareQuality.com)
conformance testing  (SearchSoftwareQuality.com)
error handling  (SearchSoftwareQuality.com)
garbage in, garbage out  (SearchSoftwareQuality.com)
load testing  (SearchSoftwareQuality.com)
NUnit  (SearchSoftwareQuality.com)
quality assurance  (SearchSoftwareQuality.com)
stress testing  (SearchSoftwareQuality.com)
white box  (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



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 enterprise IT professionals with the information they need to perform their jobs - from developing strategy, to making cost-effective IT purchase decisions and managing their organizations' IT projects - with its network of technology-specific Web sites, events and magazines.

TechTarget Corporate Web Site  |  Media Kits  |  Reprints  |  Site Map




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