summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJames Young <xxiinophobia@yahoo.com>2020-01-25 16:07:08 -0800
committerskullydazed <skullydazed@users.noreply.github.com>2020-01-25 18:15:07 -0800
commit72d7661b30d139077087dac723efb3582dc1011e (patch)
tree16a832994aecf82b790a94d72225cd9d9badb123 /docs
parentd0d106cef75b4121374020fca633e8fc2628cef0 (diff)
suggestions by skullydazed
Diffstat (limited to 'docs')
-rw-r--r--docs/breaking_changes_instructions.md6
1 files changed, 6 insertions, 0 deletions
diff --git a/docs/breaking_changes_instructions.md b/docs/breaking_changes_instructions.md
index d264884c05..3f2f93834f 100644
--- a/docs/breaking_changes_instructions.md
+++ b/docs/breaking_changes_instructions.md
@@ -12,11 +12,17 @@ Some things that may cause a pull request to be flagged are:
Changes may also require action to be taken by users, such as updating a toolchain or taking some action in Git.
- **Changes Necessitating Increased Scrutiny**
On occasion, a submission may have implications for QMK as a project. This could be copyright/licensing issues, coding conventions, large feature overhauls, "high-risk" changes that need wider testing by our community, or something else entirely.
+- **Changes Requiring Communication to End Users**
+ This includes warnings about future deprecations, outdated practices, and anything else that needs to be communicated but doesn't fit into one of the above categories.
## What Do I Do?
If it is determined that your submission is a breaking change, there are a few things you can do to smooth the process:
+### Consider Splitting Up Your PR
+
+If you are contributing core code, and the only reason it needs to go through breaking changes is that you are updating keymaps to match your change, consider whether you can submit your feature in a way that the old keymaps continue to work. Then submit a separate PR that goes through the breaking changes process to remove the old code.
+
### Contribute a ChangeLog Entry
We require submissions that go through the Breaking Change process to include a changelog entry. The entry should be a short summary of the changes your pull request makes &ndash; [each section here started as a changelog](ChangeLog/20190830.md "n.b. This should link to the 2019 Aug 30 Breaking Changes doc - @noroadsleft").