docs(linter): Improve the docs for import/unambiguous. (#18474)

connorshea · connorshea · commit 2fa83a433bee · 2026-01-24T04:28:40.000Z
diff --git a/crates/oxc_linter/src/rules/import/unambiguous.rs b/crates/oxc_linter/src/rules/import/unambiguous.rs
@@ -16,11 +16,12 @@ pub struct Unambiguous;
 declare_oxc_lint!(
     /// ### What it does
     ///
-    /// Warn if a `module` could be mistakenly parsed as a `script` and not pure ESM module
+    /// Warn if a `module` could be mistakenly parsed as a `script` instead of
+    /// as a pure [ES module](https://nodejs.org/api/esm.html#modules-ecmascript-modules).
     ///
     /// ### Why is this bad?
     ///
-    /// For ESM-only environments helps to determine files that not pure ESM modules
+    /// For ESM-only environments, ambiguous files may lead to unexpected results and problems.
     ///
     /// ### Examples
     ///
