Explain ASI issues aren't always auto-fixed (#14174)

theScottyJam · fisker · web-flow · commit 2a5b391cc05e · 2023-02-18T11:14:18.000+08:00
Co-authored-by: fisker Cheung &lt;lionkay@gmail.com&gt;
diff --git a/docs/rationale.md b/docs/rationale.md
@@ -187,6 +187,24 @@ With a semicolon in front of that `[` such issues never happen. It makes the lin
 
 This practice is also common in [standard] which uses a semicolon-free style.
 
+Note that if your program currently has a semicolon-related bug in it, Prettier _will not_ auto-fix the bug for you. Remember, Prettier only reformats code, it does not change the behavior of the code. Take this buggy piece of code as an example, where the developer forgot to place a semicolon before the `(`:
+
+<!-- prettier-ignore -->
+```js
+console.log('Running a background task')
+(async () => {
+  await doBackgroundWork()
+})()
+```
+
+If you feed this into Prettier, it will not alter the behavior of this code, instead, it will reformat it in a way that shows how this code will actually behave when ran.
+
+```js
+console.log("Running a background task")(async () => {
+  await doBackgroundWork();
+})();
+```
+
 [standard]: https://standardjs.com/rules.html#semicolons
 
 ### Print width
diff --git a/website/versioned_docs/version-stable/rationale.md b/website/versioned_docs/version-stable/rationale.md
@@ -188,6 +188,24 @@ With a semicolon in front of that `[` such issues never happen. It makes the lin
 
 This practice is also common in [standard] which uses a semicolon-free style.
 
+Note that if your program currently has a semicolon-related bug in it, Prettier _will not_ auto-fix the bug for you. Remember, Prettier only reformats code, it does not change the behavior of the code. Take this buggy piece of code as an example, where the developer forgot to place a semicolon before the `(`:
+
+<!-- prettier-ignore -->
+```js
+console.log('Running a background task')
+(async () => {
+  await doBackgroundWork()
+})()
+```
+
+If you feed this into Prettier, it will not alter the behavior of this code, instead, it will reformat it in a way that shows how this code will actually behave when ran.
+
+```js
+console.log("Running a background task")(async () => {
+  await doBackgroundWork();
+})();
+```
+
 [standard]: https://standardjs.com/rules.html#semicolons
 
 ### Print width
