Meego Wiki
Views

Quality/Testability-commenting

From MeeGo wiki
(Difference between revisions)
Jump to: navigation, search
Line 5: Line 5:
Current testability analysis provides no real value. Marking a feature as testable does not mean that an adequate test can be written from the description. The process of marking a feature as testable will now require feedback from the feature owner. This will introduce an extra step to the process. The process now looks like this:
Current testability analysis provides no real value. Marking a feature as testable does not mean that an adequate test can be written from the description. The process of marking a feature as testable will now require feedback from the feature owner. This will introduce an extra step to the process. The process now looks like this:
# The feature owner creates a [FEA] bug and describes a feature
# The feature owner creates a [FEA] bug and describes a feature
-
# The QA contact comments on the feature with a testability analysis and a theoretical test description. Requests that the feature owner 'OK' the test.
+
# The QA contact comments on the feature with a testability analysis and a theoretical test description.  
 +
## Requests that the feature owner 'OK' the test.
 +
## Sets Testability field to 'No'
# Feature owner comments on the theoretical test.
# Feature owner comments on the theoretical test.
-
# If the test is adequate, the feature is marked as testable, if it is not, go back to 2.
+
# If the test is adequate, the feature is marked as testable (set testability field to 'Yes'), if it is not, go back to 2.
=== Testability Analysis ===
=== Testability Analysis ===
Line 52: Line 54:
   
   
  Feature Assignee: Please confirm if this test is adequate to verify that the
  Feature Assignee: Please confirm if this test is adequate to verify that the
-
  feature works. The feature can then be marked as testable.
+
  feature works. The feature has been marked as not testable. Testability will
 +
be set to 'Yes' after the Feature Assignee has commented on the test.
== Conclusion ==
== Conclusion ==
By allowing a little more time for testability studies, feature owners/developers can be provided with a clear view on the testing of their feature. This can help avoid misunderstandings with regard to feature functions and can make feature verification easier.
By allowing a little more time for testability studies, feature owners/developers can be provided with a clear view on the testing of their feature. This can help avoid misunderstandings with regard to feature functions and can make feature verification easier.

Revision as of 07:43, 1 December 2010

Contents

Introduction

In the past, a QA contact marked a feature with a yes/no statement and a checklist. This does not add any useful information to the process and provides little useful feedback for the feature owner. The objective of this document is to lay down guidelines for feature testability comments that will allow for discussion about test development with the feature owner.

The Process

Current testability analysis provides no real value. Marking a feature as testable does not mean that an adequate test can be written from the description. The process of marking a feature as testable will now require feedback from the feature owner. This will introduce an extra step to the process. The process now looks like this:

  1. The feature owner creates a [FEA] bug and describes a feature
  2. The QA contact comments on the feature with a testability analysis and a theoretical test description.
    1. Requests that the feature owner 'OK' the test.
    2. Sets Testability field to 'No'
  3. Feature owner comments on the theoretical test.
  4. If the test is adequate, the feature is marked as testable (set testability field to 'Yes'), if it is not, go back to 2.

Testability Analysis

The testability checklist can be found here: Feature Testability Checklist

The QA Contact should analyze the feature description and compare it to the requirements of the Testability Checklist. A yes/no verdict should be supplied (in the comment), and, (especially if the verdict is no) a justification should be provided for the verdict. If the feature cannot be tested, suggesting a method to rectify the situation is strongly suggested.

Theoretical Test

In general, the person who would know how best to test a feature is the feature developer themselves. The suggested way to get their input about the feature and have the information easily accessible is to suggest a test while commenting on the testability.

The suggested test can consist of a name and/or a test description.

By suggesting a test to the feature developer, the barriers for participating in the test development process are lowered. While the test developer may not have time or be inclined to describe a test on their own, if a test is suggested, they can easily comment on the suggested test. This makes it easier to catch a misinterpretation of the feature in an early stage, and can allow for better, more complete, tests.

Marking a Feature as Testable

A feature should only be marked as Testable after the feature owner has confirmed that the test is adequate to test his/her feature.

Benefits for Feature Verification

By suggesting a test (especially with a test case name), feature verification will be easier as all the information required for feature verification is already present in the feature bugzilla.

Template

This template is suggested for use when commenting features:

Testability statement as per: http://wiki.meego.com/Quality/TestabilityChecklist

1. Can I write a test based on the information in this description?
  Yes/No. Comment?

2. Are relevant technology parameters available (Sample rates, Bit Rates,
supported picture sizes, etc.) described?
  Yes/No. Comment?

3. For Core OS: Is API Under test defined clearly?
  Yes/No. Comment?

Summary: Testability is OK/not OK.

Required from assignee to fix Testability: List here if Testability is NOT OK


QA Proposed test as per: http://wiki.meego.com/Quality/Testability-commenting

Test would ... If ... the test would pass.

Feature Assignee: Please confirm if this test is adequate to verify that the
feature works. The feature has been marked as not testable. Testability will
be set to 'Yes' after the Feature Assignee has commented on the test.


Conclusion

By allowing a little more time for testability studies, feature owners/developers can be provided with a clear view on the testing of their feature. This can help avoid misunderstandings with regard to feature functions and can make feature verification easier.

Personal tools