Fix 545 broken .md links and add dark/light theme toggle to documentation

[Copilot]

The HTML documentation contained 110 unique broken links to non-existent .md files. Additionally, the site lacked a theme toggle despite having theme support built-in.

Changes

Link Fixes (183 files, 545 replacements)

• Replace .md links with correct HTML directory paths
• Map grammar/GLOSSARY.md → GLOSSARY/
• Map root-level docs (AGENTS.md, ARCHITECTURE.md, etc.) → directory paths with trailing /
• Redirect src/* paths to GitHub repository URLs
• Redirect CONTRIBUTING.md to GitHub blob URL

Dark/Light Mode Toggle (183 files)

• Add theme toggle button in header before search
• Toggle between default (light) and slate (dark) via data-md-color-scheme
• Persist preference to localStorage
• IIFE initialization prevents theme flash on load
• Icon swaps: sun (☀️) in light mode, moon (🌙) in dark mode

<button class="md-header__button md-icon theme-toggle-button" 
        onclick="toggleTheme()">
  <svg id="theme-icon-light">...</svg>
  <svg id="theme-icon-dark" style="display: none;">...</svg>
</button>

<script>
function toggleTheme() {
  const scheme = body.getAttribute('data-md-color-scheme');
  body.setAttribute('data-md-color-scheme', 
    scheme === 'slate' ? 'default' : 'slate');
  localStorage.setItem('theme-preference', newScheme);
}
</script>

Note: Changes are to generated HTML. If site rebuilds from source, theme toggle needs MkDocs config implementation.

Original prompt

arregla los enlaces de toda la documentacion

Custom agent used: TNFR
TNFR Agent

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.