From 02977f25a922dd0b8617c16116bb4364d0f30e94 Mon Sep 17 00:00:00 2001
From: Kevin Partington <platinum.azure@kernelpanicstudios.com>
Date: Tue, 15 Oct 2019 16:31:50 -0500
Subject: [PATCH] Docs: Clarify `eslint:recommended` semver policy (#12429)

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index c12264b9fad..1ad5e537600 100644
--- a/README.md
+++ b/README.md
@@ -156,8 +156,9 @@ ESLint follows [semantic versioning](https://semver.org). However, due to the na
     * A new CLI capability is created.
     * New capabilities to the public API are added (new classes, new methods, new arguments to existing methods, etc.).
     * A new formatter is created.
+    * `eslint:recommended` is updated and will result in strictly fewer errors (e.g., rule removals).
 * Major release (likely to break your lint build)
-    * `eslint:recommended` is updated.
+    * `eslint:recommended` is updated and may result in new errors (e.g., rule additions, most rule option updates).
     * A new option to an existing rule that results in ESLint reporting more errors by default.
     * An existing formatter is removed.
     * Part of the public API is removed or changed in an incompatible way.