Update documentation with latest references and versions (#1780)

* Update documentation with latest references and versions

Added 'Further reading' links to Axe rules in 'id-unique' and 'input-requires-label' docs. Updated GitHub Actions versions in code scanning usage guide. Updated embedded HTMLHint version in VS Code extension documentation from 1.7.0 to 1.8.0.

* Update website/AGENTS.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: coliff

website/AGENTS.md

@@ -0,0 +1,11 @@
+# Agents
+
+<!-- https://agents.md -->
+
+- The site is built with Astro Starlight.
+- The site is hosted on Cloudflare Pages.
+
+## Rules pages
+
+- For accessibility rules, add a 'Further Reading' link at the bottom to the relevant documentation and prefer MDN and Axe.
+- Where appropriate, add a 'Why this rule is important' section to the rule page.

website/src/content/docs/rules/id-unique.mdx

@@ -30,3 +30,5 @@ Level: <Badge text="Error" variant="danger" />
 ### Why this rule is important
 
 Duplicate ID attributes can cause unexpected behavior and make the code harder to read and maintain.
+
+Further reading: [Axe Rules - duplicate-id](https://dequeuniversity.com/rules/axe/4.1/duplicate-id)

website/src/content/docs/rules/input-requires-label.mdx

@@ -38,3 +38,5 @@ Level: <Badge text="Warning" variant="caution" />
 ### Why this rule is important
 
 This rule ensures that the input element has a corresponding label element for accessibility compliance.
+
+Further reading: [Axe Rules - input elements must have labels](https://dequeuniversity.com/rules/axe/4.1/label)

website/src/content/docs/usage/github-code-scanning.mdx

@@ -34,12 +34,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           persist-credentials: false
 
       - name: Set up Node.js
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
 
       # If you need a website build script, include the steps here
 
@@ -48,7 +48,7 @@ jobs:
         # Continue even if HTMLHint finds issues
 
       - name: Upload SARIF file
-        uses: github/codeql-action/upload-sarif@v3
+        uses: github/codeql-action/upload-sarif@v4
         with:
           sarif_file: website/htmlhint.sarif
           category: HTMLHint

website/src/content/docs/vs-code-extension.mdx

@@ -9,7 +9,7 @@ import { LinkCard, CardGrid } from '@astrojs/starlight/components'
 
 Get realtime linting feedback in Visual Studio Code with the HTMLHint extension. This extension provides a seamless integration of HTMLHint into your development workflow, allowing you to catch HTML issues as you type.
 
-The HTMLHint extension will attempt to use the locally installed HTMLHint module (the project-specific module if present, or a globally installed HTMLHint module). If a locally installed HTMLHint isn't available, the extension will use the embedded version (current version 1.7.0).
+The HTMLHint extension will attempt to use the locally installed HTMLHint module (the project-specific module if present, or a globally installed HTMLHint module). If a locally installed HTMLHint isn't available, the extension will use the embedded version (current version 1.8.0).
 
 ## Download