(chore): adjust comments on Auto Update workflow

The comments for the `Run kubebuilder alpha update`
step are now properly syntax-highlighted as such in
yaml.

The `--use-gh-models` flag is now properly referenced
in the comments.

Author: vitorfloriano

docs/book/src/getting-started/testdata/project/.github/workflows/auto_update.yml

@@ -58,14 +58,14 @@ jobs:
     # Step 6: Run the Kubebuilder alpha update command.
     # More info: https://kubebuilder.io/reference/commands/alpha_update
     - name: Run kubebuilder alpha update
+      # Executes the update command with specified flags.
+      # --force: Completes the merge even if conflicts occur, leaving conflict markers.
+      # --push: Automatically pushes the resulting output branch to the 'origin' remote.
+      # --restore-path: Preserves specified paths (e.g., CI workflow files) when squashing.
+      # --open-gh-issue: Creates a GitHub Issue with a link for opening a PR for review.
+      # --use-gh-models: Adds an AI-generated comment to the created Issue with
+      #   a short overview of the scaffold changes and conflict-resolution guidance (If Any).
       run: |
-       # Executes the update command with specified flags.
-       # --force: Completes the merge even if conflicts occur, leaving conflict markers.
-       # --push: Automatically pushes the resulting output branch to the 'origin' remote.
-       # --restore-path: Preserves specified paths (e.g., CI workflow files) when squashing.
-       # --open-gh-issue: Creates a GitHub Issue with a link for opening a PR for review.
-       # --open-gh-models: Adds an AI-generated comment to the created Issue with
-       #   a short overview of the scaffold changes and conflict-resolution guidance (If Any).
         kubebuilder alpha update \
           --force \
           --push \

pkg/plugins/optional/autoupdate/v1alpha/scaffolds/internal/github/auto_update.go

@@ -102,14 +102,14 @@ jobs:
     # Step 6: Run the Kubebuilder alpha update command.
     # More info: https://kubebuilder.io/reference/commands/alpha_update
     - name: Run kubebuilder alpha update
+      # Executes the update command with specified flags.
+      # --force: Completes the merge even if conflicts occur, leaving conflict markers.
+      # --push: Automatically pushes the resulting output branch to the 'origin' remote.
+      # --restore-path: Preserves specified paths (e.g., CI workflow files) when squashing.
+      # --open-gh-issue: Creates a GitHub Issue with a link for opening a PR for review.
+      # --use-gh-models: Adds an AI-generated comment to the created Issue with
+      #   a short overview of the scaffold changes and conflict-resolution guidance (If Any).
       run: |
-       # Executes the update command with specified flags.
-       # --force: Completes the merge even if conflicts occur, leaving conflict markers.
-       # --push: Automatically pushes the resulting output branch to the 'origin' remote.
-       # --restore-path: Preserves specified paths (e.g., CI workflow files) when squashing.
-       # --open-gh-issue: Creates a GitHub Issue with a link for opening a PR for review.
-       # --open-gh-models: Adds an AI-generated comment to the created Issue with
-       #   a short overview of the scaffold changes and conflict-resolution guidance (If Any).
         kubebuilder alpha update \
           --force \
           --push \

testdata/project-v4-with-plugins/.github/workflows/auto_update.yml

@@ -58,14 +58,14 @@ jobs:
     # Step 6: Run the Kubebuilder alpha update command.
     # More info: https://kubebuilder.io/reference/commands/alpha_update
     - name: Run kubebuilder alpha update
+      # Executes the update command with specified flags.
+      # --force: Completes the merge even if conflicts occur, leaving conflict markers.
+      # --push: Automatically pushes the resulting output branch to the 'origin' remote.
+      # --restore-path: Preserves specified paths (e.g., CI workflow files) when squashing.
+      # --open-gh-issue: Creates a GitHub Issue with a link for opening a PR for review.
+      # --use-gh-models: Adds an AI-generated comment to the created Issue with
+      #   a short overview of the scaffold changes and conflict-resolution guidance (If Any).
       run: |
-       # Executes the update command with specified flags.
-       # --force: Completes the merge even if conflicts occur, leaving conflict markers.
-       # --push: Automatically pushes the resulting output branch to the 'origin' remote.
-       # --restore-path: Preserves specified paths (e.g., CI workflow files) when squashing.
-       # --open-gh-issue: Creates a GitHub Issue with a link for opening a PR for review.
-       # --open-gh-models: Adds an AI-generated comment to the created Issue with
-       #   a short overview of the scaffold changes and conflict-resolution guidance (If Any).
         kubebuilder alpha update \
           --force \
           --push \