From f61f2ba430be52aabc3059fe649046c332c6588f Mon Sep 17 00:00:00 2001
From: Santhi Prakash <38608178+santhiprakash@users.noreply.github.com>
Date: Wed, 26 Aug 2026 01:50:29 +0530
Subject: [PATCH] docs: clarify that Prettier is not rule-based (#19793)

---
 docs/comparison.md                                  | 2 ++
 website/versioned_docs/version-stable/comparison.md | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/docs/comparison.md b/docs/comparison.md
index 882ca74f5..323428948 100644
--- a/docs/comparison.md
+++ b/docs/comparison.md
@@ -11,6 +11,8 @@ Linters have two categories of rules:
 
 Prettier alleviates the need for this whole category of rules! Prettier is going to reprint the entire program from scratch in a consistent way, so it’s not possible for the programmer to make a mistake there anymore :)
 
+Prettier is not a rule-based tool: it has no individual formatting rules that you can enable or disable. It reprints your whole program from scratch instead.
+
 **Code-quality rules**: eg [no-unused-vars](https://eslint.org/docs/rules/no-unused-vars), [no-extra-bind](https://eslint.org/docs/rules/no-extra-bind), [no-implicit-globals](https://eslint.org/docs/rules/no-implicit-globals), [prefer-promise-reject-errors](https://eslint.org/docs/rules/prefer-promise-reject-errors)…
 
 Prettier does nothing to help with those kind of rules. They are also the most important ones provided by linters as they are likely to catch real bugs with your code!
diff --git a/website/versioned_docs/version-stable/comparison.md b/website/versioned_docs/version-stable/comparison.md
index 882ca74f5..323428948 100644
--- a/website/versioned_docs/version-stable/comparison.md
+++ b/website/versioned_docs/version-stable/comparison.md
@@ -11,6 +11,8 @@ Linters have two categories of rules:
 
 Prettier alleviates the need for this whole category of rules! Prettier is going to reprint the entire program from scratch in a consistent way, so it’s not possible for the programmer to make a mistake there anymore :)
 
+Prettier is not a rule-based tool: it has no individual formatting rules that you can enable or disable. It reprints your whole program from scratch instead.
+
 **Code-quality rules**: eg [no-unused-vars](https://eslint.org/docs/rules/no-unused-vars), [no-extra-bind](https://eslint.org/docs/rules/no-extra-bind), [no-implicit-globals](https://eslint.org/docs/rules/no-implicit-globals), [prefer-promise-reject-errors](https://eslint.org/docs/rules/prefer-promise-reject-errors)…
 
 Prettier does nothing to help with those kind of rules. They are also the most important ones provided by linters as they are likely to catch real bugs with your code!