From fc95d42b35cf802e48579acf236115fbd8e8baf0 Mon Sep 17 00:00:00 2001 From: shamoon <4887959+shamoon@users.noreply.github.com> Date: Fri, 12 Sep 2025 15:51:49 -0700 Subject: [PATCH] Documentation: add guidance for feature PRs in CONTRIBUTING.md --- CONTRIBUTING.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 2f7952ad0..8572b5fd3 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -2,9 +2,14 @@ If you feel like contributing to the project, please do! Bug fixes and improvements are always welcome. +!!! warning + + Pull requests that implement a new feature or enhancement *should almost always target an existing feature request* with evidence of community interest and discussion. This is in order to balance the work of implementing and maintaining new features / enhancements. Pull requests that are opened without meeting + this requirement may not be merged. + If you want to implement something big: -- Please start a discussion about that in the issues! Maybe something similar is already in development and we can make it happen together. +- As above, please start with a discussion! Maybe something similar is already in development and we can make it happen together. - When making additions to the project, consider if the majority of users will benefit from your change. If not, you're probably better of forking the project. - Also consider if your change will get in the way of other users. A good change is a change that enhances the experience of some users who want that change and does not affect users who do not care about the change. - Please see the [paperless-ngx merge process](#merging-prs) below.