Update mkdocs-material to 9.7.1 and fix deprecated configurations

[Copilot]

The docs build process was using mkdocs-material 5.5.0 (from 2020) with several deprecated configurations that would fail with newer versions.

Changes

Dockerfile (docs/Dockerfile)

• Updated base image: squidfunk/mkdocs-material:5.5.0 → 9.7.1
• Added mkdocs-git-revision-date-localized-plugin dependency
• Removed unnecessary build dependencies (gcc, musl-dev)

Configuration (mkdocs.yml)

• Emoji: materialx.emoji.twemoji → material.extensions.emoji.twemoji
• Syntax highlighting: codehilite → pymdownx.highlight + pymdownx.inlinehilite
• Tabs: Added alternate_style: true to pymdownx.tabbed
• Removed deprecated theme options: include_search_page, search_index_only
• Removed deprecated search option: prebuild_index: python

Documentation (CONTRIBUTING.md)

• Added build instructions with Docker commands:

  docker build -t mkdocs -f ./docs/Dockerfile ./
  docker run --rm -v "$(pwd):/docs" mkdocs build --strict
  docker run --rm -p 8000:8000 -v "$(pwd):/docs" mkdocs serve --dev-addr 0.0.0.0:8000

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Update the docs build process</issue_title>
<issue_description>We should update the docs build process which includes the docker file in the docs folder so that it's using current versions of the mkdocs tools</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Update the docs build process #294

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.