docs: improve documentation markup

src/parsing/swift-file-tree.ts

@@ -94,7 +94,7 @@ export class SwiftFileTree {
       return [];
     }
 
-    // A SwiftUI view is a property declaration with an opaque type annotation that matches "some View".
+    // A SwiftUI view is a property declaration with an opaque type annotation that matches `some View`.
     const swiftUIViewQueryText = `
       (
         (property_declaration
@@ -119,7 +119,7 @@ export class SwiftFileTree {
 
   /**
    * Replace the text in the tree with the given replacement text.
-   * Prefer using `replaceNode` instead of this method, which uses this one under the hood.
+   * Prefer using {@link replaceNode} instead of this method, which uses this one under the hood.
    */
   replaceText(
     originalStart: Point,

src/transforming/rules/accessibility-hidden-modifier-remover.ts

@@ -6,7 +6,7 @@ import {
 } from '../fault-transformation-rule.js';
 
 /**
- * This rule matches to a SwiftUI View element with a `.accessibilityHidden` modifier, which
+ * This rule matches to a SwiftUI view element with a `.accessibilityHidden` modifier, which
  * is used to hide views with decorative or repetitive content from screen readers. The transformation
  * removes the modifier.
  *

src/transforming/rules/accessibility-modifier-remover.ts

@@ -6,7 +6,7 @@ import {
 } from '../fault-transformation-rule.js';
 
 /**
- * This rule matches to a SwiftUI View element with a `.accessibility` modifier, which
+ * This rule matches to a SwiftUI view element with a `.accessibility` modifier, which
  * is used to provide a text alternative for screen reader users to a view that doesn't
  * display text. The transformation removes the label.
  *