summaryrefslogtreecommitdiffstats
path: root/googletest
diff options
context:
space:
mode:
authorGennadiy Civil <gennadiycivil@users.noreply.github.com>2017-08-10 13:13:45 (GMT)
committerGitHub <noreply@github.com>2017-08-10 13:13:45 (GMT)
commit75f0723c4522ae70724d71b1facdde3ecdf35975 (patch)
tree46b523bddea45a7076a311282450e53bbc6277f6 /googletest
parentb322d1d91d92b2e38513f0fc86de9e93314d8006 (diff)
parentc09e9e646de834b54162f584710eff2d72232080 (diff)
downloadgoogletest-75f0723c4522ae70724d71b1facdde3ecdf35975.zip
googletest-75f0723c4522ae70724d71b1facdde3ecdf35975.tar.gz
googletest-75f0723c4522ae70724d71b1facdde3ecdf35975.tar.bz2
Merge pull request #1178 from aninf-wo/hethi/testsuite-hint
add note about different definitions of Test Case
Diffstat (limited to 'googletest')
-rw-r--r--googletest/docs/Primer.md34
1 files changed, 34 insertions, 0 deletions
diff --git a/googletest/docs/Primer.md b/googletest/docs/Primer.md
index be6ad38..ae2dfa1 100644
--- a/googletest/docs/Primer.md
+++ b/googletest/docs/Primer.md
@@ -23,6 +23,40 @@ So let's go!
_Note:_ We sometimes refer to Google C++ Testing Framework informally
as _Google Test_.
+# Beware of the nomenclature #
+
+_Note:_ There might be some confusion of idea due to different
+definitions of the terms _Test_, _Test Case_ and _Test Suite_, so beware
+of misunderstanding these.
+
+Historically, the Google C++ Testing Framework started to use the term
+_Test Case_ for grouping related tests, whereas current publications
+including the International Software Testing Qualifications Board
+([ISTQB](http://www.istqb.org/)) and various textbooks on Software
+Quality use the term _[Test
+Suite](http://glossary.istqb.org/search/test%20suite)_ for this.
+
+The related term _Test_, as it is used in the Google C++ Testing
+Framework, is corresponding to the term _[Test
+Case](http://glossary.istqb.org/search/test%20case)_ of ISTQB and
+others.
+
+The term _Test_ is commonly of broad enough sense, including ISTQB's
+definition of _Test Case_, so it's not much of a problem here. But the
+term _Test Case_ as used in Google Test is of contradictory sense and thus confusing.
+
+Unfortunately replacing the term _Test Case_ by _Test Suite_ throughout
+the Google C++ Testing Framework is not easy without breaking dependent
+projects, as `TestCase` is part of the public API at various places.
+
+So for the time being, please be aware of the different definitions of
+the terms:
+
+Meaning | Google Test Term | [ISTQB](http://www.istqb.org/) Term
+------- | ---------------- | -----------------------------------
+Exercise a particular program path with specific input values and verify the results | [TEST()](#simple-tests) | [Test Case](http://glossary.istqb.org/search/test%20case)
+A set of several tests related to one component | [Test Case](#basic-concepts) | [Test Suite](http://glossary.istqb.org/search/test%20suite)
+
# Setting up a New Test Project #
To write a test program using Google Test, you need to compile Google