Update sidebar.json for to allow top nav tabs.

[g-samroberts]

Summary

Update sidebar.json to support multiSidebar plugin in the website.

Closes #19359

Details

The side nav is getting crowded. This change creates a Docs, Reference, Resources, and Changelog tab in the website to help distribute the number of pages we have.

How to Validate

Ran the site locally using updates in the site repo as well as this new file structure and sidebar.json file..

Pre-Merge Checklist

• Updated relevant documentation and README (if needed)
• Added/updated tests (if needed)
• Noted breaking changes (if any)
• Validated on required platforms/methods:
  • MacOS
    • npm run
    • npx
    • Docker
    • Podman
    • Seatbelt
  • Windows
    • npm run
    • npx
    • Docker
  • Linux
    • npm run
    • npx
    • Docker

[gemini-code-assist]

Summary of Changes

Hello @g-samroberts, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request implements a significant refactoring of the documentation sidebar structure to enhance website navigation and reduce visual clutter. By introducing new top-level navigation tabs, the extensive documentation content is now logically grouped, making it easier for users to find relevant information. This change supports the integration of a multi-sidebar plugin, laying the groundwork for a more organized and user-friendly documentation experience.

Highlights

• Sidebar Restructuring: The sidebar.json file has been fundamentally restructured to support a multi-sidebar plugin, enabling a more organized documentation layout.
• Top-Level Navigation Tabs: New top-level navigation tabs, including 'Docs', 'Reference', 'Resources', and 'Releases' (Changelog), have been introduced to categorize and distribute documentation content.
• Improved Content Organization: Existing documentation sections have been re-categorized and nested under these new top-level tabs, significantly reducing sidebar clutter and enhancing user navigation.

Changelog

• docs/sidebar.json
  • Restructured the JSON array to introduce new top-level objects representing navigation tabs (e.g., "docs_tab", "reference_tab").
  • Nested existing documentation sections (e.g., "Get started", "Features", "Configuration") under the appropriate new top-level tabs.
  • Modified the "label" property of the primary navigation entries to reflect the new tab structure.

Activity

• No specific activity (comments, reviews, or progress updates) has been recorded for this pull request yet.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

This pull request refactors the docs/sidebar.json file to support a multi-sidebar navigation structure for the documentation website. The changes introduce a new top-level grouping for tabs like 'Docs', 'Reference', 'Resources', and 'Releases', and correctly moves the existing sidebar sections under these new tabs. The new structure is consistent and appears to be well-tested, as mentioned in the pull request description. I have reviewed the changes and found no issues. The refactoring is clean and achieves the stated goal of reorganizing the navigation.

[github-actions]

Size Change: -2 B (0%)

Total Size: 24.6 MB

ℹ️ View Unchanged

Filename	Size	Change
./bundle/gemini.js	24.5 MB	-2 B (0%)
./bundle/sandbox-macos-permissive-open.sb	890 B	0 B
./bundle/sandbox-macos-permissive-proxied.sb	1.31 kB	0 B
./bundle/sandbox-macos-restrictive-open.sb	3.36 kB	0 B
./bundle/sandbox-macos-restrictive-proxied.sb	3.56 kB	0 B
./bundle/sandbox-macos-strict-open.sb	4.82 kB	0 B
./bundle/sandbox-macos-strict-proxied.sb	5.02 kB	0 B

_{compressed-size-action}

[jkcinouye]

LGTM.

[g-samroberts]

Do not merge until site changes are approved.