diff --git a/crates/rome_js_analyze/src/analyzers/no_async_promise_executor.rs b/crates/rome_js_analyze/src/analyzers/no_async_promise_executor.rs
index b7e54dcbb45..52c1aab26de 100644
--- a/crates/rome_js_analyze/src/analyzers/no_async_promise_executor.rs
+++ b/crates/rome_js_analyze/src/analyzers/no_async_promise_executor.rs
@@ -5,9 +5,10 @@ use rome_rowan::{AstNode, AstSeparatedList};
declare_rule! {
/// Disallows using an async function as a Promise executor.
+ ///
/// The executor function can also be an async function. However, this is usually a mistake, for a few reasons:
- /// If an async executor function throws an error, the error will be lost and won't cause the newly-constructed `Promise` to reject. This could make it difficult to debug and handle some errors.
- /// If a Promise executor function is using `await`, this is usually a sign that it is not actually necessary to use the `new Promise` constructor, or the scope of the `new Promise` constructor can be reduced.
+ /// 1. If an async executor function throws an error, the error will be lost and won't cause the newly-constructed `Promise` to reject. This could make it difficult to debug and handle some errors.
+ /// 2. If a Promise executor function is using `await`, this is usually a sign that it is not actually necessary to use the `new Promise` constructor, or the scope of the `new Promise` constructor can be reduced.
///
/// ## Examples
/// ### Valid
diff --git a/website/src/docs/lint/rules/index.md b/website/src/docs/lint/rules/index.md
index 5d553181c86..da1cfbd744f 100644
--- a/website/src/docs/lint/rules/index.md
+++ b/website/src/docs/lint/rules/index.md
@@ -19,9 +19,6 @@ eleventyNavigation:
Disallows using an async function as a Promise executor.
-The executor function can also be an async function. However, this is usually a mistake, for a few reasons:
-If an async executor function throws an error, the error will be lost and won't cause the newly-constructed Promise
to reject. This could make it difficult to debug and handle some errors.
-If a Promise executor function is using await
, this is usually a sign that it is not actually necessary to use the new Promise
constructor, or the scope of the new Promise
constructor can be reduced.