Welcome to EMC Consulting Blogs Sign in | Join | Help

BI Tester

Testing all things BI

The Importance of Being Documented

I cannot stress how crucial it is for a Tester to have an understanding of the architectures and underlying cohesiveness of the system and this can  be understood from Project Documentation.

Test Strategy and Scripts have a very strong dependency on Project Documentation, so when this is poorly executed you could have poor testing.  

As you may have guessed it’s important to be able to assess document quality and demand for better quality where needed.

One way to assess this quality is to use the 5Ws (Rudyard Kipling)

I keep six honest serving-men
(They taught me all I knew);
Their names are What and Why and When
And How and Where and Who.

 

So far I have come across some documents that say what they do but not why they do it.

“Why” is important than just the “what” you do,  as it makes the what relevant and in context and provides connectivity.

 

I have built an application and this is what I did to make it work.... why?  To do calculations

 

Applying where (location) and when (time) constraints highlights any important issues that might get overlooked. 

The next thing is How. How is essential for actions to be taken by the reader/circulation list

How do you implement this?  What are the prerequisites needed to do this.

Create separate paragraphs for the How defining usage of what was created and why it was created

Mixing what’s and how’s together without separating and you may lose emphasis on "hot soup" areas.

Using the 5Ws helps define, contextualise, highlight and activate you into action ensuring Test Strategy and Scripts serve their purpose and dont gather dust.

Published 05 March 2009 13:47 by jennifer.orji

Comments

 

hugorodgerbrown said:

How does this work in an Agile environment where developers are reluctant to document anything? What is the minimum set of docs required - are there any absolute must-haves?

March 5, 2009 17:29
 

jennifer.orji said:

In Agile  - when providing user stories we have the "who" , "what"  and sometimes  you say the "why"  .

In the process of implementing this story the developer/ team can provide the tester with the "when", "where"  and "how" part  .... eg.

As a user (who) i would like to perform a calculation (what )

so that i can make an accurate bill to my customer ( why)

when  i have completed  the  calculation  i want it sent  to the customer (when , where)

Obeying my own instructions , I then discuss the "how"  separately  taking into account that the How explains the 5ws

How does this work

I ( who) want to be able to enter all the calculations (what) and click send  (when, where )

Now looking closer the "how" is an exact test that the user will perform ... our job is now easy  :-)

During a scrum you could ask the when , where  and how part and discuss  this  with the team, and dont get too carried away, for System Integration Tests ensure that you link all these mini activities to make a complete process, smooth this out by discussing any links that are not clear

Hope this solves some of the frustrations

March 5, 2009 18:07
Anonymous comments are disabled

This Blog

Syndication

News

Locations of visitors to this page
Powered by Community Server (Personal Edition), by Telligent Systems