From 2fa83a433bee1d9bb28bce3af2423027bbbe3edd Mon Sep 17 00:00:00 2001
From: connorshea <2977353+connorshea@users.noreply.github.com>
Date: Sat, 24 Jan 2026 04:28:40 +0000
Subject: [PATCH] docs(linter): Improve the docs for import/unambiguous.
 (#18474)

---
 crates/oxc_linter/src/rules/import/unambiguous.rs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/crates/oxc_linter/src/rules/import/unambiguous.rs b/crates/oxc_linter/src/rules/import/unambiguous.rs
index d9cd0cf4c24b4..2bb70117cb13f 100644
--- 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
     ///