Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Terminology: Logical/Concrete Test Case

Open
#70 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
1-2 days
Newbie friendliness
48/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Active

Research direction

Start by reading chapter "3. Terminology" in the spec and the discussion referenced in issue #66. Review every use of "logical test case" and "logical run", then update the terminology and Test Case definition so the proposed distinction is consistent throughout the spec.

Written by the indexing model from the issue text.

Description

I'd like to shed light on the term "logical test case".

Preface: Currently the spec in chapter "3. Terminology" does not "define" the term "logical test case".

Problem

IMHO, the term “logical test case” causes confusion when used in conjunction with the parameterization of test cases because it refers to something "abstract". But the opposite is the case.

Why?

  • A test case consists of a flow logic plus a set of parameters.
  • In case of an non-empty set of parameters the same flow logic is executed multiple times.
  • So it can be said that the flow logic is not "complete" and not "concrete" enough.
  • So it could also be said that the flow logic actually is the "logical" part of each of the concrete executions.
Proposal

I propose to:

  1. exchange "logical test case" by "concrete test case" in the spec
  2. extend the definition of "Test Case" as followed:

Test Case:
An individual executable test, represented in CTRF as an entry within the tests array.
An individual executable test, if parametrized, consists of the flow logic and a set of parameters.
This combination forms a "Concrete Test Case".

This is not yet streamlined, you will probably come up with a better way to phrase it.

Notes:

  • By the way , this is not contradictory to "logical run". A "logical run" consists of multiple "concrete runs".
  • I felt obliged to mention the term “concrete test case” in my comment to issue #66 because I suspect that the term “logical test case” obscures our understanding of testId.
Dominant language
No language data
Stars
98
Forks
4
Avg merge
1h 21m
Merged PRs (30d)
1

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from ctrf-io/ctrf

All issues in ctrf-io/ctrf

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.