Migrate files to resource or references folder.

[g-samroberts]

Summary

Migrate files to resource or references folder. Update existing links.

Related to #19359

Details

This is step two in unblocking multisidebar for the website. Putting these files into the correct folders allows us to make sure we can group reference and resource files by folder in the top nav.

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-cli]

Hi @g-samroberts, thank you so much for your contribution to Gemini CLI! We really appreciate the time and effort you've put into this.

We're making some updates to our contribution process to improve how we track and review changes. Please take a moment to review our recent discussion post: Improving Our Contribution Process & Introducing New Guidelines.

Key Update: Starting January 26, 2026, the Gemini CLI project will require all pull requests to be associated with an existing issue. Any pull requests not linked to an issue by that date will be automatically closed.

Thank you for your understanding and for being a part of our community!

[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 focuses on a significant refactoring of the documentation structure by moving various files into dedicated reference and resources folders. This change is a foundational step towards enabling a multisidebar layout for the website, which will enhance user experience by providing a more intuitive and organized navigation system for documentation. The primary impact is an improved logical grouping of content and seamless access to information through updated links.

Highlights

• Documentation Restructuring: Migrated numerous documentation files into new reference and resources subdirectories to improve organization and prepare for a multisidebar website layout.
• Link Updates: Updated all internal links across the documentation to reflect the new file paths, ensuring navigation remains functional after the file migrations.
• Sidebar Navigation Refinement: Adjusted the sidebar.json file to correctly point to the newly organized documentation sections, enhancing the website's navigation structure.

Changelog

• CONTRIBUTING.md
  • Updated the link to the FAQ document to reflect its new path.
• docs/changelogs/index.md
  • Updated the link to the policy engine documentation.
• docs/cli/cli-reference.md
  • Updated the link to the policy engine documentation within the CLI options table.
• docs/cli/commands.md
  • Renamed to docs/reference/commands.md.
  • Updated internal links to configuration documentation.
• docs/cli/enterprise.md
  • Updated links to configuration, policy engine, and tools API documentation in multiple sections.
• docs/cli/gemini-md.md
  • Updated the link to the memory import processor documentation.
• docs/cli/keyboard-shortcuts.md
  • Renamed to docs/reference/keyboard-shortcuts.md.
• docs/cli/model.md
  • Updated the link to the configuration documentation.
• docs/cli/plan-mode.md
  • Updated the link to the policy engine guide.
• docs/cli/sandbox.md
  • Updated links to configuration and troubleshooting documentation in the related documentation section.
• docs/cli/telemetry.md
  • Updated the link to the configuration guide.
• docs/cli/themes.md
  • Updated links to configuration documentation regarding theme persistence and precedence.
• docs/cli/tutorials/memory-management.md
  • Updated the link to the command reference.
• docs/cli/tutorials/session-management.md
  • Updated the link to the command reference.
• docs/cli/uninstall.md
  • Renamed to docs/resources/uninstall.md.
• docs/core/index.md
  • Updated the link to the command reference for memory management.
• docs/core/memport.md
  • Renamed to docs/reference/memport.md.
• docs/core/policy-engine.md
  • Renamed to docs/reference/policy-engine.md.
• docs/core/subagents.md
  • Updated the link to the configuration documentation regarding 'YOLO mode'.
• docs/core/tools-api.md
  • Renamed to docs/reference/tools-api.md.
• docs/extensions/reference.md
  • Updated the link to the CLI configuration documentation for MCP servers.
• docs/faq.md
  • Renamed to docs/resources/faq.md.
  • Updated internal link to configuration documentation.
• docs/get-started/authentication.md
  • Updated links to quota and pricing, and terms of service and privacy notice documents.
• docs/get-started/configuration.md
  • Renamed to docs/reference/configuration.md.
  • Updated internal links to memory import processor and commands documentation.
• docs/index.md
  • Removed a large block of outdated feature links.
  • Reordered some feature links for better presentation.
  • Updated numerous links in the 'Reference' and 'Resources' sections to point to their new paths.
• docs/quota-and-pricing.md
  • Renamed to docs/resources/quota-and-pricing.md.
• docs/sidebar.json
  • Updated numerous navigation links to reflect the new file paths for 'Help', 'Memory management', 'Shell', 'Stats', 'Tools', 'Command reference', 'Configuration reference', 'Keyboard shortcuts', 'Memory import processor', 'Policy engine', 'Tools API', 'FAQ', 'Quota and pricing', 'Terms and privacy', 'Troubleshooting', and 'Uninstall'.
• docs/tools/index.md
  • Updated the link to the command reference.
• docs/tools/internal-docs.md
  • Updated the example path for documentation files.
  • Updated links to command reference and configuration guide.
• docs/tools/shell.md
  • Updated the link to the policy engine documentation.
• docs/tos-privacy.md
  • Renamed to docs/resources/tos-privacy.md.
  • Updated internal links to quota and pricing, and usage statistics configuration.
• docs/troubleshooting.md
  • Renamed to docs/resources/troubleshooting.md.
• scripts/generate-keybindings-doc.ts
  • Updated the output path for the generated keyboard shortcuts documentation.
• scripts/generate-settings-doc.ts
  • Updated the output path for the generated configuration documentation.

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 primarily involves reorganizing documentation files by moving them into new resources and reference directories. The changes are extensive, covering numerous markdown files, documentation generation scripts, and the website's sidebar configuration to update links and paths according to the new structure. Overall, the refactoring is well-executed, but I found one instance of a broken link that needs to be corrected.

[chrstnb]

Build failed: Build process failed with link errors:

02:59:56 [ERROR] ✗ Found 13 invalid links in 9 files.
02:59:56   └─ /docs/cli/commands - invalid link
02:59:56   ├─ /docs/core/tools-api - invalid link
02:59:56   ├─ /docs/core/memport - invalid link
02:59:56   └─ /docs/core/policy-engine - invalid link
02:59:56   └─ /docs/get-started/configuration - invalid link
02:59:56   └─ /docs/get-started/configuration#environment-variable-redaction - invalid link
02:59:56   └─ /docs/resources/reference/configuration - invalid link
02:59:56   └─ /docs/resources/cli/sandbox - invalid link
02:59:56   ├─ /docs/reference/settings - invalid link
02:59:56   └─ /docs/reference/custom-commands - invalid link
02:59:56   ├─ /docs/reference/authentication - invalid link
02:59:56   └─ /docs/reference/authentication - invalid link
02:59:56 [ERROR] [starlight-links-validator-integration] An unhandled error occurred while running the "astro:build:done" hook

[github-actions]

Size Change: -2 B (0%)

Total Size: 24.5 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. I didn't manually check all the links - just read through them - since linting caught errors.