Diff
1diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
2index 1abae89131ebdb057e7ac1c164354c731cb977ce..5c94caeb5a9907aff9b724d51d20ef1b9986af63 100644
3--- a/.github/PULL_REQUEST_TEMPLATE.md
4+++ b/.github/PULL_REQUEST_TEMPLATE.md
5@@ -9,6 +9,7 @@
6 - [ ] The code is mine or it's from somewhere with an MIT-compatible license.
7 - [ ] The code is efficient, to the best of my ability, and does not waste computer resources.
8 - [ ] The code is stable and I have tested it myself, to the best of my abilities.
9+- [ ] If the code introduces new aliases, I provide a valid use case for all plugin users down below.
10
11 ## Changes:
12
13diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
14index 2bd877892385d0a3efe4d950554df0cb731cdd94..59cf96012c471c0ad65f5bdf26c1959ab0a8f254 100644
15--- a/CONTRIBUTING.md
16+++ b/CONTRIBUTING.md
17@@ -104,6 +104,27 @@ maintainers) by mentioning their GitHub handle (starting with `@`) in your messa
18
19 For any extensive change, such as a new plugin, you will have to find testers to +1 your PR.
20
21+### New plugin aliases
22+
23+We acknowledge that aliases are a core part of Oh My Zsh. There are plugins that have +100 aliases!
24+
25+This has become an issue for two opposing reasons:
26+
27+- Some users want to have their personal aliases in Oh My Zsh.
28+- Some users don't want any aliases at all and feel that there are too many.
29+
30+Because of this, from now on we're requiring that new aliases follow these conditions:
31+
32+1. They will be used by many people, not just a few.
33+2. The aliases will be used many times and for common tasks.
34+3. Prefer one generic alias over many specific ones.
35+4. When justifying the need for an alias, talk about workflows where you'll use it,
36+ preferably in combination with other aliases.
37+5. If there exists a command with the same name, look for a different alias name.
38+
39+This list is not exhaustive! Please remember that your alias will be in the machines of many people,
40+so it should be justified why they should have it.
41+
42 ----
43
44 ## Use the Search, Luke