Read-only mirrors. Development, issues and pull requests are on GitHub.

summaryrefslogtreecommitdiffhomepage
path: root/.github/ISSUE_TEMPLATE/feature_request.md
blob: 7ea4ab8959db30346a39459d32c1f4805b67e7cd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
---
name: Feature request
about: Propose an improvement to Progmasoft Catch3
title: "[Feature] "
---

<!--
SPDX-FileCopyrightText: Catch2 Authors
SPDX-FileCopyrightText: 2026 Progmasoft <support@progmasoft.com>
SPDX-License-Identifier: LGPL-3.0-or-later AND BSL-1.0
-->

Read [Catch3's scope and compatibility policy](https://github.com/Progmasoft/catch3/blob/devel/docs/why-catch3.md) before proposing a change. Catch3 additions and changes to the Catch2-compatible engine have different ownership and compatibility constraints.

### Problem and use case

What testing task is difficult today? Include a concrete example from a real test suite.

### Proposed behavior

Describe the user-facing API or runner behavior, with a short C++17 example if useful. Explain how failures should be reported and reproduced.

### Ownership and compatibility

- Does this belong in `Progmasoft::Catch3`, the compatibility engine, build tooling, or documentation?
- Would it change existing Catch2 headers, macros, command-line behavior, or reporters?
- Would it need compiled code, a new dependency, or a new minimum compiler version?

### Alternatives and validation

What workaround exists today? What focused test would show that the proposed behavior works?