feat(docs): add exclusive rules and fix headings (#1602)

crates/biome_js_analyze/src/analyzers/a11y/no_svg_without_title.rs

@@ -36,7 +36,7 @@ declare_rule! {
     /// </svg>
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// <svg>

crates/biome_js_analyze/src/analyzers/a11y/use_anchor_content.rs

@@ -38,7 +38,7 @@ declare_rule! {
     /// <a><span aria-hidden="true">content</span></a>
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```jsx
     /// <a>content</a>

crates/biome_js_analyze/src/analyzers/a11y/use_heading_content.rs

@@ -22,7 +22,7 @@ declare_rule! {
     /// <h1></h1>
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```jsx
     /// <h1>heading</h1>

crates/biome_js_analyze/src/analyzers/complexity/no_for_each.rs

@@ -37,7 +37,7 @@ declare_rule! {
     /// })
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// els.forEach((el, i) => {

crates/biome_js_analyze/src/analyzers/complexity/no_static_only_class.rs

@@ -40,7 +40,7 @@ declare_rule! {
     /// }
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// const X = {

crates/biome_js_analyze/src/analyzers/complexity/no_useless_catch.rs

@@ -31,7 +31,7 @@ declare_rule! {
     ///     doCleanUp();
     /// }
     /// ```
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// try {

crates/biome_js_analyze/src/analyzers/complexity/no_useless_constructor.rs

@@ -71,7 +71,7 @@ declare_rule! {
     /// }
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// class A {

crates/biome_js_analyze/src/analyzers/complexity/no_useless_empty_export.rs

@@ -36,7 +36,7 @@ declare_rule! {
     /// export {};
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// export {};

crates/biome_js_analyze/src/analyzers/complexity/use_arrow_function.rs

@@ -44,7 +44,7 @@ declare_rule! {
     /// }
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// const f = function() {

crates/biome_js_analyze/src/analyzers/complexity/use_literal_keys.rs

@@ -42,7 +42,7 @@ declare_rule! {
     /// }
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// a["c" + "d"];

crates/biome_js_analyze/src/analyzers/complexity/use_regex_literals.rs

@@ -37,7 +37,7 @@ declare_rule! {
     /// new RegExp("abc", "u");
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// /abc/u;

crates/biome_js_analyze/src/analyzers/complexity/use_simple_number_keys.rs

@@ -36,7 +36,7 @@ declare_rule! {
     /// ({ 11_1.11: "ee" });
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// ({ 0: "zero" });

crates/biome_js_analyze/src/analyzers/correctness/no_empty_character_class_in_regex.rs

@@ -24,7 +24,7 @@ declare_rule! {
     /// /^a[^]/.test("ax"); // true
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// /^a[xy]/.test("ay"); // true

crates/biome_js_analyze/src/analyzers/correctness/no_nonoctal_decimal_escape.rs

@@ -43,7 +43,7 @@ declare_rule! {
     /// const x = "Don't use \9 escape.";
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// const x = "8";

crates/biome_js_analyze/src/analyzers/correctness/no_self_assign.rs

@@ -53,7 +53,7 @@ declare_rule! {
     /// a['b'].foo = a['b'].foo;
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// a &= a;

crates/biome_js_analyze/src/analyzers/correctness/no_unsafe_optional_chaining.rs

@@ -50,7 +50,7 @@ declare_rule! {
     /// (baz?.bar).foo;
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// (obj?.foo)?.();

crates/biome_js_analyze/src/analyzers/nursery/no_empty_block_statements.rs

@@ -35,7 +35,7 @@ declare_rule! {
     /// }
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// function foo () {

crates/biome_js_analyze/src/analyzers/nursery/no_empty_type_parameters.rs

@@ -23,7 +23,7 @@ declare_rule! {
     /// type Bar<> = {};
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```ts
     /// interface Foo {}

crates/biome_js_analyze/src/analyzers/nursery/no_unused_private_class_members.rs

@@ -49,7 +49,7 @@ declare_rule! {
     ///  }
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// class UsedMember {

crates/biome_js_analyze/src/analyzers/nursery/no_useless_lone_block_statements.rs

@@ -35,7 +35,7 @@ declare_rule! {
     /// }
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// while (foo) {

crates/biome_js_analyze/src/analyzers/nursery/no_useless_ternary.rs

@@ -29,7 +29,7 @@ declare_rule! {
     /// var a = foo + 1 ? true : false;
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// var a = x === 2 ? 'Yes' : 'No';

crates/biome_js_analyze/src/analyzers/nursery/use_grouped_type_import.rs

@@ -48,7 +48,7 @@ declare_rule! {
     /// import { type A } from "mod";
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```ts
     /// import type { A, B } from "mod";

crates/biome_js_analyze/src/analyzers/nursery/use_shorthand_function_type.rs

@@ -42,7 +42,7 @@ declare_rule! {
     /// }
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```ts
     /// type Example = () => string;

crates/biome_js_analyze/src/analyzers/style/no_default_export.rs

@@ -44,7 +44,7 @@ declare_rule! {
     /// export { X as default };
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// export function f () {};

crates/biome_js_analyze/src/analyzers/style/no_namespace.rs

@@ -30,7 +30,7 @@ declare_rule! {
     /// declare namespace foo {}
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```ts
     /// import foo from 'foo';

crates/biome_js_analyze/src/analyzers/style/no_useless_else.rs

@@ -63,7 +63,7 @@ declare_rule! {
     /// }
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// function f(x) {

crates/biome_js_analyze/src/analyzers/style/use_as_const_assertion.rs

@@ -36,7 +36,7 @@ declare_rule! {
     /// let foo = { bar: 'baz' as 'baz' };
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```ts
     /// let foo = 'bar';

crates/biome_js_analyze/src/analyzers/style/use_literal_enum_members.rs

@@ -29,7 +29,7 @@ declare_rule! {
     /// }
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```ts
     /// enum Direction {

crates/biome_js_analyze/src/analyzers/style/use_shorthand_assign.rs

@@ -37,7 +37,7 @@ declare_rule! {
     /// a = a * 1;
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// a += 1;

crates/biome_js_analyze/src/analyzers/suspicious/no_approximative_numeric_constant.rs

@@ -19,7 +19,7 @@ declare_rule! {
     /// let x = 2.302;
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// let x = Math.PI;

crates/biome_js_analyze/src/analyzers/suspicious/no_duplicate_class_members.rs

@@ -47,7 +47,7 @@ declare_rule! {
     /// }
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// class Foo {

crates/biome_js_analyze/src/analyzers/suspicious/no_fallthrough_switch_clause.rs

@@ -32,7 +32,7 @@ declare_rule! {
     /// }
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// switch (foo) {

crates/biome_js_analyze/src/analyzers/suspicious/no_implicit_any_let.rs

@@ -24,7 +24,7 @@ declare_rule! {
     /// b = 1
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```ts
     /// var a = 1;

crates/biome_js_analyze/src/analyzers/suspicious/no_misrefactored_shorthand_assign.rs

@@ -36,7 +36,7 @@ declare_rule! {
     /// a *= a * b
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// a += b

crates/biome_js_analyze/src/analyzers/suspicious/no_prototype_builtins.rs

@@ -31,7 +31,7 @@ declare_rule! {
     /// var invalid = foo.propertyIsEnumerable("bar");
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// var valid = Object.hasOwn(foo, "bar");

crates/biome_js_analyze/src/analyzers/suspicious/use_getter_return.rs

@@ -39,7 +39,7 @@ declare_rule! {
     /// }
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// class Person {

crates/biome_js_analyze/src/analyzers/suspicious/use_namespace_keyword.rs

@@ -31,7 +31,7 @@ declare_rule! {
     /// module Example {}
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```ts
     /// namespace Example {}

crates/biome_js_analyze/src/aria_analyzers/a11y/no_aria_hidden_on_focusable.rs

@@ -26,7 +26,7 @@ declare_rule! {
     /// <a href="/" aria-hidden="true" />
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```js
     /// <button aria-hidden="true" tabIndex="-1" />

crates/biome_js_analyze/src/aria_analyzers/a11y/no_aria_unsupported_elements.rs

@@ -22,7 +22,7 @@ declare_rule! {
     /// <html aria-required="true" />
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```jsx
     /// <meta charset="UTF-8" />

crates/biome_js_analyze/src/aria_analyzers/a11y/no_interactive_element_to_noninteractive_role.rs

@@ -26,7 +26,7 @@ declare_rule! {
     /// <input role="img" />;
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```jsx
     /// <input role="button" />;

crates/biome_js_analyze/src/aria_analyzers/a11y/no_noninteractive_tabindex.rs

@@ -34,7 +34,7 @@ declare_rule! {
     /// <article tabIndex="0" />
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```jsx
     /// <div />

crates/biome_js_analyze/src/aria_analyzers/a11y/no_redundant_roles.rs

@@ -29,7 +29,7 @@ declare_rule! {
     /// <h1 role='heading' aria-level='1'>title</h1>
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```jsx
     /// <article role='presentation'></article>

crates/biome_js_analyze/src/aria_analyzers/a11y/use_aria_activedescendant_with_tabindex.rs

@@ -38,7 +38,7 @@ declare_rule! {
     /// <div aria-activedescendant={someID} />
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```jsx
     /// <div aria-activedescendant={someID} tabIndex={0} />

crates/biome_js_analyze/src/semantic_analyzers/a11y/use_button_type.rs

@@ -28,7 +28,7 @@ declare_rule! {
     /// React.createElement('button');
     /// ```
     ///
-    /// ## Valid
+    /// ### Valid
     ///
     /// ```jsx
     /// <>