Commit: runtime(doc): update Vim policy

[Christian Brabandt]

runtime(doc): update Vim policy

Commit: https://github.com/vim/vim/commit/e89efc22be5f2fa04f3e072f62303845fbc7b1b3
Author: shane.xb.qian <shane...@foxmail.com>
Date: Tue Sep 23 20:09:18 2025 +0000

runtime(doc): update Vim policy

closes: https://github.com/vim/vim/issues/18372

Signed-off-by: shane.xb.qian <shane...@foxmail.com>
Signed-off-by: Christian Brabandt <c...@256bit.org>

diff --git a/runtime/doc/develop.txt b/runtime/doc/develop.txt
index 70176f831..85bc7d7e6 100644
--- a/runtime/doc/develop.txt
+++ b/runtime/doc/develop.txt
@@ -1,4 +1,4 @@
-*develop.txt* For Vim version 9.1. Last change: 2025 Sep 07
+*develop.txt* For Vim version 9.1. Last change: 2025 Sep 23


VIM REFERENCE MANUAL by Bram Moolenaar
@@ -424,6 +424,14 @@ The basic steps to make changes to the code:
For any non-trivial change, please always create a pull request on github,
since this triggers the test suite.

+A PR should ideally contain a single commit for a single logical change.
+However, you can include several commits if you want to group multiple
+logical, atomic changes in one PR. This can also make longer PRs easier to
+review. Be sure to describe the reasoning for your changes in each commit
+message, as this greatly helps with the review process. In cases where each
+commit handles different logical changes, they will also be applied as
+separate patches in Vim’s repository.
+
*style-clang-format*
sound.c and sign.c can be (semi-) automatically formatted using the
`clang-format` formatter according to the distributed .clang-format file.