From e5911f0b09832e72b5047f0259a9c9d97e830a8e Mon Sep 17 00:00:00 2001 From: David Stansby Date: Mon, 27 Sep 2021 14:28:30 +0100 Subject: [PATCH] Backport PR #21192: Discourage making style changes to extern/. --- doc/devel/contributing.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/doc/devel/contributing.rst b/doc/devel/contributing.rst index 91c54ebff800..bda9e9c0274b 100644 --- a/doc/devel/contributing.rst +++ b/doc/devel/contributing.rst @@ -343,6 +343,11 @@ C/C++ extensions docstrings, and the Numpydoc format is well understood in the scientific Python community. +* C/C++ code in the :file:`extern/` directory is vendored, and should be kept + close to upstream whenever possible. It can be modified to fix bugs or + implement new features only if the required changes cannot be made elsewhere + in the codebase. In particular, avoid making style fixes to it. + .. _keyword-argument-processing: Keyword argument processing