refactor(lint/useGetterReturn): improve rule docs (#26)

crates/rome_js_analyze/src/analyzers/nursery/use_getter_return.rs

@@ -7,10 +7,7 @@ use rome_rowan::{AstNode, NodeOrToken, TextRange};
 use rustc_hash::FxHashSet;
 
 declare_rule! {
-    /// Enforces the presence of non-empty `return` statements in getters.
-    ///
-    /// A _getter_ allows defining a property which is dynamically computed.
-    /// Thus, it is desirable that a _getter_ returns a value.
+    /// Enforce `get` methods to always return a value.
     ///
     /// Source: https://eslint.org/docs/latest/rules/getter-return
     ///
@@ -32,6 +29,18 @@ declare_rule! {
     /// }
     /// ```
     ///
+    /// ```js,expect_diagnostic
+    /// class Option {
+    ///     get value() {
+    ///         if (this.hasValue) {
+    ///             log();
+    ///         } else {
+    ///             return null;
+    ///         }
+    ///     },
+    /// }
+    /// ```
+    ///
     /// ## Valid
     ///
     /// ```js

website/src/pages/lint/rules/index.mdx

@@ -1081,7 +1081,7 @@ Enforce all dependencies are correctly specified.
 <h3 data-toc-exclude id="useGetterReturn">
 	<a href="/lint/rules/useGetterReturn">useGetterReturn</a>
 </h3>
-Enforces the presence of non-empty <code>return</code> statements in getters.
+Enforce <code>get</code> methods to always return a value.
 </section>
 <section class="rule">
 <h3 data-toc-exclude id="useGroupedTypeImport">