From afc2a7d652383a43555dc4717276f0171dfca993 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Florian=20M=C3=BCllner?= Date: Wed, 17 Jan 2024 03:54:29 +0100 Subject: [PATCH] docs: Add section on feature requests Small and well-defined feature requests can be very useful, but unfortunately too many are neither small nor well-defined. Try to improve on that by adding another README section that explains that changes need design approval, and points to appropriate places to have broader design discussions, hopefully without being too off-putting. While this is unlikely to stop all "bad" feature requests, it at least gives us something to point to when closing requests. Part-of: --- README.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/README.md b/README.md index 592a58f31..4f3841b18 100644 --- a/README.md +++ b/README.md @@ -51,6 +51,28 @@ you can use: [matrix-room]: https://matrix.to/#/#gnome-shell:gnome.org [discourse]: https://discourse.gnome.org +## Feature requests + +gnome-shell is a core compoment of the GNOME desktop experience. +As such, any changes in behavior or appearance only happen in +accordance with the [GNOME design team][design-team]. + +For major changes, it is best to start a discussion on [discourse] +and reach out on the [#gnome-design matrix room][design-room], +and only involve the issue tracker once agreement has been reached. + +In particular mockups must be approved by the design team to be +considered for implementation. + +For enhancements that are limited in scope and well-defined, +it is acceptable to directly open a feature request. + +When in doubt, it is better to ask before opening an issue. + +[design-team]: https://gitlab.gnome.org/Teams/Design +[discourse]: https://discourse.gnome.org +[design-room]: https://matrix.to/#/#gnome-design:gnome.org + ## Contributing To contribute, open merge requests at https://gitlab.gnome.org/GNOME/gnome-shell.