Remove unused files and update index and sidebar.

[g-samroberts]

Summary

Remove unused files and update index and sidebar.

Removed files:
cli/index.md: Basically the same as top-level index.md, except outdated.
concepts.md: Short document that describes a handful of key terms. These should be explained in user guides or feature docs.
configuration-v1.md: Original config file from almost 6 months ago. This will confuse users and AI.
architecture.md: Document that discusses how the repository is organized. Unnecessary.

Related to #19359

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 focuses on enhancing the clarity and organization of the project's documentation. It involves a significant cleanup by removing obsolete files and a restructuring of the main index and sidebar to improve navigation and introduce new relevant topics. The changes aim to provide a more accurate and user-friendly documentation experience.

Highlights

• Documentation Cleanup: Removed several outdated and unused documentation files, including architecture overviews, CLI index, core concepts, and deprecated configuration guides.
• Documentation Index Update: Updated the main docs/index.md file to reflect current documentation structure, adding new sections for 'Development' and 'Releases' and incorporating new topics like 'Remote Agents' and 'Subagents'.
• Sidebar Navigation Refinement: Modified docs/sidebar.json to align with the updated documentation, adding new entries for 'Remote Agents' and 'Subagents' and removing links to the deleted architecture and core concepts documents.
• Link Correction: Corrected an outdated link in docs/get-started/examples.md to point to the appropriate file management guide.

Changelog

• docs/architecture.md
  • Removed the architecture overview document.
• docs/cli/index.md
  • Removed the main CLI usage documentation.
• docs/core/concepts.md
  • Removed the core concepts documentation.
• docs/get-started/configuration-v1.md
  • Removed the deprecated v1 configuration documentation.
• docs/get-started/examples.md
  • Updated a navigation link to the file management guide.
• docs/index.md
  • Added new links for 'Remote Agents' and 'Subagents' under 'Features'.
  • Removed 'Architecture overview' and 'Core concepts' from 'Deep technical documentation'.
  • Introduced new 'Development' and 'Releases' sections with relevant links.
• docs/sidebar.json
  • Added 'Remote Agents' and 'Subagents' to the 'Features' section.
  • Removed 'Architecture' and 'Core concepts' from the 'Reference' section.

Activity

• The pull request is related to issue Update sidebar.json for additional website tabs. #19359, indicating a planned documentation update.
• The author has marked the relevant documentation and README as updated in the pre-merge checklist.

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

Code Review

This pull request cleans up the documentation by removing several unused or deprecated markdown files and updating the main documentation index and sidebar configuration accordingly. The changes are consistent and correctly reflect the new documentation structure. The modifications are well-executed and I have no feedback at this time.

[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}

[chrstnb]

Build failed: Build process failed with link errors:

22:26:32 [ERROR] ✗ Found 2 invalid links in 2 files.
22:26:32   └─ /docs/get-started/configuration-v1 - invalid link
22:26:32   └─ /docs/cli#user-guides - invalid link
22:26:32 [ERROR] [starlight-links-validator-integration] An unhandled error occurred while running the "astro:build:done" hook

[jkcinouye]

LGTM - one nit, which is that the page is actually called Remote subagents.