From 8d689755a5b55c2184c30fcdb70acc8cfa01574e Mon Sep 17 00:00:00 2001 From: Ashok Narayan Date: Fri, 13 Mar 2026 19:15:36 +0530 Subject: [PATCH] docs: clarify meaning of 'test crashes' in primer Explain that a crash refers to abnormal termination such as uncaught exceptions or runtime errors. Fixes confusion reported in issue #4790. --- docs/primer.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/primer.md b/docs/primer.md index 69d6c6ddc..305f1c66d 100644 --- a/docs/primer.md +++ b/docs/primer.md @@ -83,8 +83,10 @@ that check whether a condition is true. An assertion's result can be *success*, *nonfatal failure*, or *fatal failure*. If a fatal failure occurs, it aborts the current function; otherwise the program continues normally. -*Tests* use assertions to verify the tested code's behavior. If a test crashes -or has a failed assertion, then it *fails*; otherwise it *succeeds*. +*Tests* use assertions to verify the tested code's behavior. If a test terminates +abnormally (for example due to an uncaught exception, segmentation fault, or +other runtime error) or has a failed assertion, then it *fails*; otherwise it +*succeeds*. A *test suite* contains one or many tests. You should group your tests into test suites that reflect the structure of the tested code. When multiple tests in a