docs: cleanup

[jenna-winkler]

Summary

Linked Issues

Documentation

• No Docs Needed:

If this PR adds new feature or changes existing. Make sure documentation is adjusted accordingly. If the docs is not needed, please explain why.

[gemini-code-assist]

Summary of Changes

Hello @jenna-winkler, 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 undertakes a significant cleanup and reorganization of the project's documentation. The primary goal is to enhance the clarity, consistency, and discoverability of information by consolidating related guides under new, more logical directory structures. This includes updating all internal links and navigation configurations, introducing a new guide for CLI server authentication, and refining existing CLI command documentation, while also removing obsolete content to streamline the overall documentation experience.

Highlights

• Documentation Restructuring: Extensive reorganization of documentation files, moving many guides from deploy/, introduction/, and how-to/ directories into a unified guides/ directory, and extensions/ content into an sdk/ directory.
• Navigation Updates: The docs/docs.json navigation configuration has been updated to reflect all file renames and path changes, ensuring that the documentation structure is consistent and navigable. The 'Integrating with Agent Stack' group was also renamed to 'Advanced Integration'.
• New CLI Guide: A new guide, docs/guides/authenticate-cli-to-server.mdx, has been added to provide instructions on connecting the Agent Stack CLI to remote servers, covering login, listing, selecting, and logging out.
• CLI Reference Enhancement: The agentstack server-side-build command in docs/guides/cli-reference.mdx has been updated with clearer descriptions and new options (--dockerfile, --replace, --add) for building agents from GitHub repositories on the platform.
• Content Removal: Two outdated guides, docs/how-to/remote-cli-guide.mdx and docs/how-to/web-interface.mdx, have been removed as part of the cleanup.

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 and cleans up the documentation by reorganizing files into guides and sdk directories, removing obsolete pages, and adding a new guide for connecting the CLI to a remote server. The changes improve the structure and clarity of the documentation. I've found a broken link in the navigation configuration and suggested a few minor improvements for consistency and better user experience in the new documentation file.