docs: Reorganize sidebar in mkdocs.yml

[saforem2]

Changes:

• Re-organize (+ alphabetize) sidebar
• Group {AI Testbeds, Aurora, Polaris, Crux, Sophia} into Machines section in sidebar

Compare current (left) vs proposed (right):



(@felker I'm gonna submit a separate PR to fix the sidebar CSS)

Copilot Summary

This pull request includes significant updates to the mkdocs.yml configuration file, focusing on enhancing the site structure, theme customization, and plugin integration.

Enhancements to site structure and navigation:

• Added new sections to the navigation (nav:) including "Facility Policies," "Machines," and "Services," providing a clearer and more organized structure for users. [1] [2] [3] [4] [5]

Theme customization:

• Introduced a new theme configuration with a custom directory, language settings, color palette, and various features like tabs, instant navigation, and search enhancements.

Additional resources:

• Included custom CSS and JavaScript files to extend the styling and functionality of the site.

Markdown extensions:

• Enabled several markdown extensions to enhance content formatting, including footnotes, admonition, code highlighting, and various pymdownx extensions for advanced markdown features.

Validation and analytics:

• Configured validation rules to handle omitted files, absolute links, unrecognized links, and more, along with integrating Google Analytics for tracking site usage.