Improve docs for ts no-extra-non-null-assertion

crates/oxc_linter/src/rules/typescript/no_extra_non_null_assertion.rs

@@ -22,13 +22,48 @@ declare_oxc_lint!(
     /// Disallow extra non-null assertions.
     ///
     /// ### Why is this bad?
-    /// The `!` non-null assertion operator in TypeScript is used to assert that a value's type does not include null or undefined. Using the operator any more than once on a single value does nothing.
     ///
-    /// ### Example
+    /// The `!` non-null assertion operator in TypeScript is used to assert that a value's type
+    /// does not include null or undefined. Using the operator any more than once on a single value
+    /// does nothing.
+    ///
+    /// ### Examples
+    ///
+    /// Examples of **incorrect** code for this rule:
     /// ```ts
     /// const foo: { bar: number } | null = null;
     /// const bar = foo!!!.bar;
     /// ```
+    ///
+    /// ```ts
+    /// function foo(bar: number | undefined) {
+    ///   const bar: number = bar!!!;
+    /// }
+    /// ```
+    ///
+    /// ```ts
+    /// function foo(bar?: { n: number }) {
+    ///   return bar!?.n;
+    /// }
+    /// ```
+    ///
+    /// Examples of **correct** code for this rule:
+    /// ```ts
+    /// const foo: { bar: number } | null = null;
+    /// const bar = foo!.bar;
+    /// ```
+    ///
+    /// ```ts
+    /// function foo(bar: number | undefined) {
+    ///  const bar: number = bar!;
+    /// }
+    /// ```
+    ///
+    /// ```ts
+    /// function foo(bar?: { n: number }) {
+    ///   return bar?.n;
+    /// }
+    /// ```
     NoExtraNonNullAssertion,
     typescript,
     correctness