Switch to Modern DocFx Theme and Added Dark Mode

[pkbullock]

• Switching theme, greatly reduces theme complexity and contains alot of the features built in e.g. dark mode, clipboard etc. and uses Bootstrap V5
• Formatting tailored to the red theme, checked in light and dark modes.
• Uses DotNet tools for DocFx
• Added local build script (instructions inside and will seek to document in the repo)

Closes #1716

Example of new Theme:

--

Copilot Summary

This pull request introduces significant improvements to the documentation site's theming, including the addition of a dark mode toggle, enhancements to the CSS for both light and dark themes, and updates to the DocFX configuration and build process. The changes modernize the site's appearance, provide users with a theme-switching option, and streamline the local documentation build experience.

Theming and UI Enhancements:

• Added a dark mode theme with comprehensive CSS variable support for both light and dark themes, including colors for backgrounds, code blocks, and alerts. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12]
• Introduced a theme toggle button in the navbar, allowing users to switch between light and dark modes. [1] [2] [3]
• Refined and expanded the CSS for the documentation site, including new styles for headings, navigation, alerts, images, code highlighting, and responsive design.

DocFX Configuration and Build Process:

• Switched DocFX installation to a .NET tool, including a new .config/dotnet-tools.json for tool management and a PowerShell script (docfx-build-local.ps1) to streamline local builds. [1] [2]
• Updated docfx.json to include the "modern" template and adjusted the footer to reference the "Material Modern UI" theme. [1] [2]

File Organization:

• Renamed the material template directory to material-classic to support coexistence with new template styles. (Fd90b496L17R17, [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13]

These updates collectively provide a more modern, user-friendly, and customizable documentation experience.

[Adam-it]

Dark mode 😍🤩

[Adam-it]

@pkbullock awesome work 👏👏👏
While testing around I noticed a few details I think it would be cool to fixup before we proceed

1. The most critical thing is that it seems the sample page does not load

2. When minimazing the size it seems we have some width that it starts to look bad but does not jump to the small size menu, it seems the old docs page does a better jump here

Also for small screen manu button I think the hamburger was bettern than the dots

3. I know it was like this before but could we along the way adda a favicon for our docs

[Adam-it]

maybe if this is not needed we could just remove this part