From 1cbf7bf561137b2f5a420a8ab35cc66c83ddb4db Mon Sep 17 00:00:00 2001 From: Antony Lee Date: Mon, 27 Sep 2021 14:07:32 +0200 Subject: [PATCH] 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