From 62ad160dff07764f86addee511f051df10e6ca69 Mon Sep 17 00:00:00 2001 From: NickSdot Date: Tue, 11 Aug 2026 16:57:02 +0700 Subject: [PATCH] docs: clarified `--CREDITS--` section --- docs/source/miscellaneous/writing-tests.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/source/miscellaneous/writing-tests.rst b/docs/source/miscellaneous/writing-tests.rst index 4339e042e6a4..40e273b6fd71 100644 --- a/docs/source/miscellaneous/writing-tests.rst +++ b/docs/source/miscellaneous/writing-tests.rst @@ -596,9 +596,10 @@ Example 1 (full): :ref:`sample001.phpt` on the first line. If the test was part of a TestFest event, then # followed by the name of the event and the date (YYYY-MM-DD) on the second line. -**Required:** No. For newly created tests this section should no longer be included, as test -authorship is already accurately tracked by Git. If multiple authors should be credited, the -`Co-authored-by` tag in the commit message may be used. +**Required:** No. For newly created tests the section should no longer be used for simple authorship +claims or listing all contributors who edited the test; as it is already accurately tracked by Git. +It may be used if more specific attribution is useful, for example to credit the original reporter +of a bug or a contributor who is not credited via `Co-authored-by` tag. **Format:** Name Email [Event]